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Section  I.  -  INTRODUCTION. 


A.  Background. 

REFERENCES : 

a.  Task  Order  from  DTIC  to  DAITC  Oct  88  (Phase  I) . 

Task  Order  from  DTIC  to  DAITC  May  89  (Phase  II) . 

Task  Order  from  DTIC  to  DAITC  Sep  89  (Phase  II  ext.). 

b.  DTIC  "Tactical  Plan  for  Automated  Management  Information 

System",  March  1987. 

c.  DTIC-EIS  Prototype  Report  (DAITC/TR-89/5) ,  7  April  1989. 

The  Defense  Technical  Information  Center  recognized  a  need 
to  provide  certain  information  items  to  senior  managers  in  a  more 
effective  manner.  While  much  of  the  information  existed,  it  was 
unclear  as  to  how  it  should  be  organized,  how  it  would  best  be 
presented,  and  to  whom.  The  DTIC  Special  Projects  Office  (SPO) 
was  requested,  through  Reference  a,  to  assist  by  demonstrating 
the  potential  of  its  EIS  technology,  using  DTIC  data. 


Reference  b  describes  a  manual  process  of  daily  management 
reports,  submitted  to  DTIC-L,  where  they  are  consolidated  and 
summarized  into  a  daily  "pipeline  report"  by  mid-afternoon.  (The 
daily  process  has  since  been  discontinued.)  This  and  other 
information  is  assembled  into  a  monthly  "Summary  Management  Data 
Report"  (SMDR) .  DTIC-L  also  produces  a  monthly  report  of  Budget 
status  from  its  "Checkbook"  system  running  on  a  personal  comput¬ 
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Reference  b  clearly  articulates  the  DTIC  need  for  "quick  and 
easy  access  to  managerial  statistical  decision  making  informa¬ 
tion"  and  "trend  reporting."  The  Management  Information  System 
envisioned  by  this  Tactical  Plan  is  comprehensive.  It  would 
incorporate  data  details  about  any  and  all  DTIC  activities; 
production  statistics,  internal  operations,  customer  histories, 
special  projects,  etc.  Such  a  system  would  ultimately  serve  the 
needs  of  not  only  the  senior  managers,  but  also  the  middle  manag¬ 
ers,  analysts  and  data  entry  staff. 

An  initial  DTIC  EIS  Prototype  was  developed  around  sample 
data  from  the  SMDR  and  Checkbook  systems.  The  Prototype  also 
included  applications  of  EIS  technology  for  Unit  Costing  data, 
Production  Backlog  statistics.  Organizational  structure  and 
Personnel  Management.  The  Prototype  experience  is  summarized  in 
Reference  c  and  was  formally  briefed  to  the  DTIC  Management  Team 
on  7  April  1989.  As  a  result  of  the  initial  Prototype  experience 
and  its  favorable  reception  by  the  DTIC  Managers,  it  was  decided 
to  extend  the  Prototype  to  active  use  within  specific  applica¬ 
tions  areas. 

The  objective  of  this  Task  was  to  establish  the  routine 
methods  of  capturing  data  for  three  specific  applications,  organ¬ 
ize  the  data  into  an  EIS  data  base,  and  provide  presentation 
methods  suitable  for  routine  use  by  DTIC  Staff  members.  This  was 
to  be  accomplished  as  an  extension  of  the  initial  prototype,  but 
still  be  less  than  a  fully  operational  Executive  Information 
System. 
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The  DTIC  Management  Reporting,  Personnel  Management  and 
Financial  Management  Systems  were  selected  as  the  initial  appli¬ 
cations  for  the  prototype  extension.  While  it  was  recognized 
that  extensive  other  data  sources  exist  at  DTIC,  it  was  decided 
that  these  three  sources  provided  a  broad  initial  base  to  which 
additional  data  sources  could  be  added.  The  three  applications 
were  developed  in  parallel  within  the  resource  constraints  of 
this  Task. 

This  Task  was  approached  as  a  Rapid  Prototyping  exercise. 
Iterative  and  interactive  exchange  between  the  DTIC  SPO  develop¬ 
ers  and  the  DTIC  users  was  expected  as  an  ongoing  feature  of  the 
process.  DTIC  was  to  provide  the  functional  guidance  in  each  of 
the  applications  areas  and  the  DTIC  SPO  was  to  accomplish  the 
technical  implementation.  As  soon  as  practical,  DTIC  users  were 
permitted  to  have  on-line  access  to  the  developing  applications 
so  as  to  provide  continuing  guidance  and  direction  to  the  devel¬ 
opment  effort. 

These  applications  should  not  be  considered  "operational" 
until  such  time  as  DTIC  obtains  in-house  hardware  and  software  to 
support  the  applications.  The  resources  for  this  step  are  beyond 
the  scope  of  this  Task. 

This  was  not  to  be  a  traditional  Life-Cycle  development 
effort.  The  technology  of  EIS  does  not  lend  itself  to  such  a 
format.  Decisions  regarding  specific  data  sources,  particular 
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screen  designs,  levels  of  documentation,  etc.  were  made  when  and 
as  needed.  These  decisions  were  made  after  necessary  coordina¬ 
tion  among  DTIC  offices  and  with  the  DTIC  SPO  developers.  Con¬ 
nectivity  between  DTIC  CARES  system  and  the  EIS  was  accomplished 
to  share  data  regarding  the  three  applications  and  provide  faster 
user  access  to  the  EIS.  The  focus  of  the  Task  was  the  develop¬ 
ment  of  EIS  applications  and  not  the  establishment  of  new  net¬ 
working  capabilities.  DTIC  was  responsible  for  establishing  the 
needed  links  to  data  sources  and  for  user  access  to  the  EIS, 
based  upon  advice  from  the  DTIC  SPO  developers. 

The  economic  benefits  of  an  EIS  are  difficult  to  quantify, 
but  none-the-less  important.  Every  effort  should  be  made  to 
substantiate  potential  and  actual  cost  savings  of  these  three  EIS 
applications  to  DTIC.  This  need  not  entail  a  comprehensive 
economic  analysis,  but  should  provide  at  least  an  initial  step  in 
that  direction. 

The  DTIC  SPO  accomplished  this  Task,  in  an  Executive  format, 
using  the  existing  DTIC  SPO  resources  of  a  MicroVax  II  computer, 
IBM-AT  workstation  and  Pilot  Command  Center  Software.  The  DTIC 
SPO  also  investigated  the  potential  of  running  this  prototype 
from  a  Macintosh  workstation  using  the  Pilot  software  package  for 
the  Macintosh,  which  is  expected  to  be  available  in  early  1990. 
Access  to  the  prototype  was  through  the  existing  DTIC  SPO/DTIC 
network.  The  same  network  could  be  used  to  establish  the  elec¬ 
tronic  connectivity  to  source  data  for  the  selected  applications. 


4 


B.  EIS  Technology. 

What  is  an  Pifpoitivp  Information  System  (EIS)  ? 

Imagine  that  you've  just  returned  to  the  office  after  an 
absence  of  several  weeks.  Maybe  it  was  that  well  deserved  annual 
leave  or  just  an  extended  business  trip.  In  any  case,  you  need 
to  catch  up  with  what  has  been  going  on  at  the  office  during  your 
absence.  And,  you  need  to  do  so  fast.  Your  boss  has  requested 
that  you  "stop  by"  in  half  an  hour  and  then  your  regular  weekly 
staff  meeting  is  in  an  hour.  What  are  the  ten  most  significant 
items  of  information  that  you  need,  right  now,  to  reestablish 
your  command  of  the  office  situation? 

The  answer  to  that  question  is  the  definition  of  YOUR  EIS! 

A  commercial  executive  might  want  to  see  current  sales 
figures,  profit  and  loss  statements,  investment  status  reports, 
and  recent  personnel  actions.  Certainly  the  ten  choices  would 
vary  with  each  individual  executive  and  with  the  type  of  business 
involved.  A  government  executive  may  be  more  concerned  about 
recent  congressional  inquiries,  the  status  of  legislative  ac¬ 
tions,  current  procurement  actions,  budget  performance,  personnel 
actions,  media  inquiries,  project  management  information,  and 
internal  organizational  politics. 

Any  system  that  can  accurately  supply  the  needed  information 
within  the  time  available  is  an  effective  Executive  Information 
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"If  potentially  valuable  information  cannot 

be  accessed  in  a  useful  way, . 

the  information  may  as  well  not  exist." 


System  or  EIS.  An  efficient 
Executive  Secretary  may  have 
anticipated  the  need  and  have 
a  "catch-up  book"  lying  on 
your  desk.  In  some  cases  that 
would  be  an  excellent  EIS.  In 
other  situations  the  EIS  might 
be  electronically  based  and 
delivered  to  the  you  via  a 


color,  touch-screen  workstation.  The  key  is  a  method,  any  meth¬ 
od,  which  separates  the  wheat  from  the  chaff  in  the  allotted 
time. 


Why  would  you  want  an  EIS?  To  Plan,  Organize,  Direct  and 
Control,  that's  why!  These  are  the  four  traditional  functions  of 
management.  We  may  vary  the  terminology,  but  these  are  the 
things  managers  do.  Each  executive  will  do  some  functions  better 
than  other  functions,  but  all  four  are  essential  to  success. 
Success  of  both  the  executive  and  the  organization.  A  well 
designed  EIS  can  support  these  objectives. 

Specifically: 

From  deep  within  the  pyramid  of  exhaustive  infor¬ 
mation  available  to  you,  you  can  extract  the  selected 
information  which  is  most  important  to  you  at  the 
moment . 
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You  can  depend  upon  the  EIS  to  "red  flag"  items 
that  violate  your  personally  prescribed  parameters.  A 
tool  for  MBO,  management  by  objectives. 


You  can  analyze  massive  amounts  of  data  at  a 
glance  with  the  graphical  displays  of  your  new  EIS. 


You  can  quickly  spot  trends  that  were  not  visible 
in  the  static  reports  which  you  formerly  used.  This 
allows  you  to  act  before  the  trend  turns  into  a  full 
blown  problem.  Analysis  of  data  over  time  is  one  of 
the  most  powerful  and  unique  aspects  of  a  well  designed 
EIS. 


You  can  establish  automated  connections  to  data 
sources  external  to  your  organization.  You  can  then 
integrate  this  vital  data  with  your  own  organizational 
sources  to  reach  your  management  decisions  from  a 
broader  perspective. 


How  do  you  get  started? 


Be  the  Champion  of  EIS  in  your  organization. 


Build  a  Prototype/Demonstration  using  a  "critical 
mass"  of  data  and/or  executive  users. 


Mold  your  implementation  strategy  and  system 
architecture  to  fit  your  organization;  not  vice  versa. 


EIS  vs.  DSS  vs.  et .  al . 


Terminology  can  seriously  detract  from  the  accomplishment  of 
significant  progress  in  an  organization.  Throughout  the  "comput¬ 
er  revolution"  or  "information  age",  if  you  prefer  that  term,  we 
have  witnessed  a  variety  of  acronyms  that  were  held  out  to  be  the 
panacea  for  all  our  administrative  problems.  Each  "new"  concept 
held  forth  the  hope  of  fulfilling  the  dream  of  total  automation 
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and  satisfying  the  unfulfilled  promises  of  its  predecessor.  A 
cynical  observation  is  that  they  all  failed  to  deliver  on  their 
promises  and  EIS  is  just  another  "buzzword"  to  keep  the  marketing 
momentum  moving. 

A  more  positive  outlook  is  that  each  of  these  terms  defined 
a  subset  of  the  whole,  offered  unique  approaches  to  automation 
within  that  subset,  and  continues  to  provide  important  contribu¬ 
tions.  Management  Information  Systems  (MIS),  Information  Re¬ 
source  Management  (IRM) ,  Information  Systems  (IS) ,  Automated 
Information  Systems  (AIS) ,  Decision  Support  Systems  (DSS) ,  Execu¬ 
tive  Information  Systems  (EIS) ,  Executive  Support  Systems  (ESS) , 
Electronic  Briefing  Systems,  War/Board  Room  Systems,  et.  al. 
give  us  unlimited  opportunity  to  define  and  differentiate  among 
technology  products  and  academic  management  theories.  An  academ¬ 
ic  may  discover  a  new  concept  or  twist  and  wishes  to  apply  a 
distinctive  label  so  that  others  can  clearly  communicate  regard¬ 
ing  this  important  discovery.  Vendors  are  very  selective  in 
categorizing  their  products  so  that  they  can  claim  some  leader¬ 
ship  position  or  unique  feature  within  their  chosen  niche.  These 
positions,  by  academics  and  vendors,  are  from  the  outside,  look¬ 
ing  in  at  an  organization. 

When  viewed  from  the  organization's  perspective,  "a  rose  by 
any  other  name  would  smell  as  sweet."  The  organization  has 
requirements  related  to  its  functional  mission.  Innovative 
automation  projects  must  address  the  real,  unique  requirements  of 
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the  organization.  Throughout  this  report,  the  term  Executive 
Information  System  (EIS)  is  used  in  the  broadest  possible  way. 
It  implies  all  of  the  technology  necessary  to  address  the  real, 
unique  requirements  of  the  organization.  It  includes  the  hard¬ 
ware,  software,  procedures,  and  people  necessary  to  make  a  posi¬ 
tive  contribution  toward  the  requirements. 

There  is  no  intent  to  limit  the  use  of  EIS  to  just  the 
executive  suite.  As  top  executives  begin  to  use  an  EIS,  their 
subordinates  will  want  to  have  access  also.  Eventually  the 
entire  management  team  becomes  active  in  the  EIS.  Supporting 
staff  members  also  become  involved,  either  as  analysts  or  in  some 
information  entry  capacity.  This  is  not  an  MIS;  an  MIS  tends  to 
be  mainframe  computer  oriented  and  focused  upon  the  recording  and 
processing  of  information.  An  EIS  is  more  focused  upon  the 
delivery  of  information.  This  is  not  a  DSS;  a  DSS  tends  to  be 
very  sophisticated  and  targeted  at  the  needs  of  analysts  and 
model  builders.  Certainly,  an  EIS  supports  the  decision  making 
processes  of  its  users,  but  in  a  less  sophisticated  and  less 
analytical  way  than  a  DSS  might. 

What,  then,  are  the  common  threads  that  bind  an  EIS?  First 
and  foremost,  an  EIS  is  intended  to  deliver  information  to  the 
cognitive  processes  of  managers.  Generally,  the  information  is 
an  aggregation  or  summary  of  the  current  status  of  the  organiza¬ 
tion.  To  be  effective,  the  information  must  be  timely  and  accu¬ 
rate.  The  EIS  architecture  must  assure  some  advantage  over  the 


current  methods  of  delivering  this  information  to  the  manager. 
The  EIS  design  must  account  for  data  entry,  transfer  from  other 
systems,  and  updates.  Given  that  the  information  is  accessible, 
the  EIS  must  provide  tools  for  the  manager  to  cope  with  the 
phenomenon  of  "information  overload." 


Some  capability  to  probe 
the  details  of  a  problem  area 
is  necessary.  This  concept  is 
sometimes  called  "drill-down." 
It  gives  the  manager  a  way  to 
pick  and  choose  the  scope  and 
level  of  detail  that  the  EIS 
delivers.  Managers  are  too 
busy  to  blindly  probe  the  vast 
pyramid  of  information  on  a 
routine  basis.  Therefore,  a  parallel  feature  of  any  good  EIS 
must  be  an  exception  reporting  mechanism. 

Management  involves  planning  and  controlling.  To  support 
these  time  oriented  activities,  an  EIS  needs  to  effectively 
deliver  trends  and/or  forecasts  to  the  manager.  This  implies  the 
use  of  charts  and  graphs.  The  effectiveness  of  the  delivery  is 
enhanced  by  the  appropriate  use  of  color.  The  design  of  the  user 
interface  is  also  critical.  If  the  EIS  is  not  easy  and  intui¬ 
tive,  managers  will  not  take  the  time  to  learn  how  to  use  the  sys- 
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tem,  particularly  if  the  current  methods  yield  adequate  results. 
This  emphasizes  the  need  for  an  EIS  to  add  value  to  current  tech¬ 
niques. 

EIS  is  a  synergistic  approach.  All  aspects  of  the  situation 
must  be  considered  simultaneously,  with  the  result  being  more 
beneficial  than  if  the  individual  components  had  been  addressed 
separately.  A  major  contribution  of  a  new  EIS  project  is  that  it 
causes  the  organization  to  question  its  current  methods.  The  EIS 
becomes  a  catalyst  for  change.  Some  individuals,  in  any  organi¬ 
zation,  find  change  threatening  and  oppose  the  EIS.  More  vision¬ 
ary  individuals  welcome  the  change.  Even  if  the  EIS  project  does 
not  become  fully  operational,  the  exercise  of  questioning  current 
practices  can  be  very  healthy. 


Implementation  Issues. 

Plan  for  success! 

The  implementation  of  EIS  technology  is  not  a  well  defined 
science.  It  has  more  of  the  characteristics  of  an  art  than  a 
science.  The  potential  surprises  due  to  unforeseen  circumstances 
are  myriad.  This  leads  some  approval  authorities  to  be  prudently 
cautious.  It  is  a  good  idea  to  include  review  points  and  even 
decisions  about  continuing  the  EIS,  at  all,  into  the  implementa¬ 
tion  plan. 
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Notwithstanding  these  review  points,  the  implementation  plan 
must  anticipate  success  and  approval-to-continue .  This  means, 
for  example,  that  the  resources  necessary  for  phase  2  should  be 
ordered,  with  an  appropriate  cancellation  clause,  prior  to  the 
formal  approval  of  the  results  of  phase  1.  The  underlying  con¬ 
cept  is  to  keep  the  momentum  and  enthusiasm  for  the  evolving  EIS 
at  an  optimum  level.  Interruptions  in  the  evolution  of  an  EIS 
project  are  serious  setbacks,  costly  in  many  ways  and  sometimes 
even  fatal. 

Planning  for  success  keeps  the  momentum  and  enthusiasm  alive 
without  obligating  the  organization  to  any  inappropriate  or 
irrevocable  steps. 

Build  upon  a  specific  need  of  an  EIS  zealot! 

Enthusiasm  is  contagious.  It  emanates  from  a  visionary 
person  who  perceives  the  potential  of  EIS  technology.  When  such 
a  visionary  can  begin  to  actually  apply  EIS  technology  to  specif¬ 
ic  functional  requirements,  the  enthusiasm  grows  and  is  shared 
with  others  in  the  organization.  It  helps  if  the  visionary  is  in 
a  position  of  authority,  but  that  is  not  essential.  The  critical 
point  is  that  the  visionary  obtains  access  to  the  EIS  technology 
and  begins  to  actively  use  it  in  meeting  daily  requirements  of 
the  job. 

An  implementation  plan  that  supports  the  requests  of  one  or 
more  visionaries  will  become  accepted  via  this  user  "pull"  far 
more  quickly  than  one  that  tries  the  technology  "push"  approach. 


Emphasize  the  added  values  to  current  Information  Systems! 

The  benefits  of  EIS  are  elusive,  but  usually  quite  real  and 
important.  For  example,  an  EIS  that  delivers  electronic  versions 
of  data  weeks  ahead  of  the  current  printed  method  is  making  a 
real  contribution.  Also,  printed  reports  are  limited  in  the 
formats,  charts  and  graphs  that  are  economical  to  deliver.  An 
electronic  EIS  of  the  same  data  can  support  drill  down,  exception 
reporting,  ad  hoc  charts,  and  robust  analysis  to  suit  each  user. 
This  is  a  powerful  added  value,  without  any  change  or  addition  to 
the  basic  data. 

It  is  important  for  an  evolving  EIS  to  highlight  such  con¬ 
tributions,  even  if  they  can  not  be  quantified  as  a  financial 
benefit. 

An  EIS  is  never  finished!  Plan  the  evolution! 

Use  phased  development.  Start  with  a  well  defined,  real 
requirement.  Maybe  a  functional  area,  such  as  Management-To- 
Payroll  (MTP) ;  or  a  lateral  application,  i.e.  the  top  layer  of 
executives;  or  possibly  a  hierarchical  EIS  for  the  financial 
management  "stovepipe.” 

Define  the  EIS  "users".  Will  they  be  just  the  managers,  or 
will  support  staff  perform  the  queries? 
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Obtain  accurate,  timely  data.  Can  it  be  imported  from 
existing  sources?  Where  will  the  "Master  Database"  reside?  Is 
direct  data  entry  required?  Will  this  create  an  additional 
class  of  "users?"  Will  this  conflict  with  the  Master  Database 
file? 


Keep  an  eye  on  the  future  to  be  prepared  for  increases  in 
numbers  of  users  and  numbers  of  applications.  Be  sure  that 
adequate  communications,  host  processing  hardware,  and  worksta¬ 
tion  software  are  available  to  respond  quickly  to  growth.  Train¬ 
ing  of  users  and  technical  support  staff  are  also  important 
growth  concerns. 

Prepare  for  the  Developmental  Surge! 

Implementation  of  an  EIS  is  a  team  requirement.  The  organi¬ 
zation  must  be  committed  to  the  end  goal  of  an  EIS  and  willing  to 
support  the  evolutionary  process.  It  is  hard  to  define  a  re¬ 
quired  composition  for  the  EIS  implementation  team.  Every  situa¬ 
tion  is  different  and  demands  a  unique  solution.  In  any  case,  it 
is  safe  to  conclude  that  multiple  skills  are  required  on  the  team 
and  that  it  is  unlikely  that  these  skills  can  be  found  in  a 
single  individual. 

Foremost  is  the  need  for  the  organizational  proponent.  This 
could  be  simply  a  directive  from  a  senior  executive,  or  the 
enthusiasm  of  an  EIS  zealot,  or  the  discovery  of  a  technical 
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support  staff  member.  The  result  is  at  least  one  person  who 
knows  the  organization,  can  effectively  work  the  organizational 
politics  that  are  bound  to  surface,  and  can  keep  the  implementa¬ 
tion  focused  upon  the  correct  targets  of  organizational  need. 
There  are  three  aspects  to  the  organizational  proponent;  a  senior 
sponsor,  a  functional  area  specialist,  and  a  technical  informa¬ 
tion  specialist.  Sometimes  three  people  emerge  to  fill  these 
roles,  sometimes  roles  are  combined  and  one  or  two  people  assume 
the  responsibilities. 

Other  skills  are  also  required  in  the  development  of  an  EIS. 
These  could  be  tapped  from  within  the  organization  or  contracted 
from  the  outside.  Some  examples  of  the  necessary  skills  are; 
computer  science,  programming,  psychology,  management  science, 
administration,  user  interface  design,  human  factors,  organiza¬ 
tional  dynamics,  change  management,  operations  research,  telecom¬ 
munications,  information  resource  management,  et.  al.  Many  of 
these  disciplines  are  the  focus  of  full  professional  careers. 
Most  of  them  have  complex  underlying  bodies  of  theory  which  are 
studied  by  academics  at  the  Doctoral  level.  It  is  clear  that  a 
team  composed  of  "experts"  would  demand  at  least  one  person  for 
each  discipline.  That  is  an  unreasonable  team  composition  for 
most  EIS  projects.  It  is  more  practical  to  seek  individuals  with 
sufficient  understanding  of  several  disciplines  who  can  guide  the 
EIS  implementation  away  from  the  most  serious  complications. 

The  EIS  implementation  team  is  a  surge  requirement.  This 
multi-disciplinary  approach  is  essential  during  the  early  stages 
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of  EIS  development,  but  need  not  continue  for  the  life  cycle  of 
the  EIS.  Once  the  EIS  architecture  has  been  established,  the 
initial  tone  for  screen  designs,  data  base  techniques,  and  model¬ 
ing  approaches  determined,  etc.,  the  need  for  specific  skills 
lessens.  Once  an  organization  begins  to  actively  use  an  EIS,  its 
future  directions  will  be  driven  by  organizational  needs. 
Changes  will  be  rather  specific  and  require  technical  support 
staff,  versus  concept  designers.  The  level  of  on-going  technical 
support  is  an  important  consideration  in  EIS  implementation 
planning.  In  any  case,  however,  on-going  support  will  be  signif¬ 
icantly  less  than  the  initial  surge  of  development  support. 
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Section  II  -  USER’S  MANUAL. 


A;  Prea»h1  p»  - 

The  following  pages  provide  detailed  comments  and  specific 
instructions  regarding  each  of  the  customized  screen  formats 
which  collectively  comprise  the  user  interface  of  the  Defense 
Technical  Information  Center  -  Executive  Information  System 
(DTIC-EIS) .  Since  the  DTIC-EIS  is  still  in  an  evolutionary 
development  stage,  these  instructions  must  be  viewed  as  prelimi¬ 
nary  and  subject  to  frequent  change.  Furthermore,  these  instruc¬ 
tions  are  supplemental  to  the  general  user  instructions  necessary 
to  effectively  use  any  Pilot  Command  Center  application. 

The  basic  architecture  of  the  DTIC-EIS  application  consists 
of  software  components  operating  simultaneously  and  cooperatively 
on  a  host  computer  (currently  a  MicroVax  II)  and  on  an  intelli¬ 
gent  user  workstation  (currently  Zenith-248  PC) .  The  host  compo¬ 
nent  manages  the  data  base  for  the  application  and  stores  the 
instructions,  permissions,  and  other  information  necessary  for 
each  user.  The  host  component  is  automatically  activated  when  an 
authorized  DTIC-EIS  user  logs  on  to  the  system.  Logging  on 
requires  the  usual  sequence  of  "username"  and  "password"  authen¬ 
tication.  Any  changes  to  this  aspect  of  the  DTIC-EIS  would 
require  the  intervention  of  trained  technical  support  personnel. 
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The  communications  link  between  the  user  workstation  and  the 
host  computer  is  another  area  requiring  trained  technical  sup¬ 
port.  There  are  a  variety  of  communications  pathways  available 
to  DTIC  users.  Each  of  the  current  DTIC-EIS  active  workstations 
have  been  set  up  to  use  at  least  one  of  these  communications 
alternatives.  The  communications  pathways  are  subject  to  fre¬ 
quent  changes  or  interruptions  which  may  affect  the  communica¬ 
tions  link  to  the  host  computer.  Difficulties  in  this  area 
should  be  brought  to  the  attention  of  DTIC's  internal  communica¬ 
tions  specialists. 

The  workstation  component  of  the  Pilot  Command  Center  soft¬ 
ware  is  placed  in  the  "pilot"  directory  of  the  workstation's  hard 
disk.  See  MS-DOS  reference  manuals  for  additional  information 
about  the  creation  and  naming  of  hard  disk  directories.  The 
minimum  software  consists  of  a  ".bat"  file  which  is  used  to 
activate  the  EIS  workstation  software  component.  The  ".bat"  file 
calls  the  executable  software  file,  "vaxmain.exe",  which  may  use 
a  customized  sequence  of  start-up  instructions  which  are  stored 
in  the  file  "login. pro."  Detailed  instructions  on  the  creation 
of  such  a  workstation  set-up  are  provided  in  the  Pilot  technical 
reference  material.  Generally,  these  steps  should  be  delegated 
to  trained  technical  support  staff. 

The  result  of  a  properly  constructed  workstation  set-up  and 
customized  host  component  is  that  the  user  simply  issues  the 
".bat"  file  command,  answers  the  appropriate  log-in  prompts,  and 
the  DTIC-EIS  Main  Screen  is  automatically  displayed. 
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The  DTIC-EIS  has  been  designed  to  be  operated  primarily  via 
a  two  button  mouse.  The  left  button  is  the  equivalent  of  "enter 
or  return"  on  the  keyboard.  Pilot  sometimes  refers  to  this 
function  as  "select."  The  right  mouse  button  is  the  equivalent 
of  the  "escape  or  cancel"  on  the  keyboard.  Keyboard  arrow  keys 
can  be  used  to  position  the  "cursor",  but  this  is  not  recommend¬ 
ed.  We  shall  use  the  term  "click"  to  represent  the  activity  of 
positioning  the  cursor  on  top  of  a  specified  area  of  the  screen 
and  "selecting"  or  pressing  the  left  mouse  button. 

Pilot  screens  consist  of  color  representations  of  labels, 
data,  or  instructions.  As  the  cursor  is  moved  around  on  the 
screen,  some  of  these  colored  areas  will  "highlight"  or  change 
color.  We  shall  refer  to  such  areas  as  "hot  buttons"  or  simply 
"buttons. " 

The  fundamental  user  instruction  for  all  Pilot  applications 
is  that  if  a  button  highlights,  you  should  be  able  to  click  on  it 
and  obtain  intuitively  obvious  results.  A  second,  equally 
fundamental  concept  of  EIS  implementation  is  that  every  screen 
should  contain  information.  In  other  words,  no  screen  should  act 
only  as  a  menu  to  get  to  some  other  screen  which  does  contain 
information.  Unfortunately,  both  of  these  objectives  are  elusive 
and  yet  to  be  attained  in  the  DTIC-EIS.  It  will  require  the 
cooperation  of  active  users  and  skilled  EIS  developers  to  ulti¬ 
mately  achieve  these  two  goals. 
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The  Pilot  software  implements  a  concept  called  "dynamic 
menus."  This  has  two  important  connotations.  First,  is  the 
already  explained  concept  of  hot  buttons.  The  content  of  a  hot 
button  may  be  text  which  is  obtained  from  the  EIS  data  base.  If 
the  data  base  content  is  changed,  the  hot  button  content  will 
automatically  be  altered  to  match.  The  second  connotation  of 
"dynamic  menus"  deals  with  the  display  of  numeric  data.  The  data 
itself  can  be  color  coded  to  convey  information,  such  as  over  or 
under  budget.  The  data  itself  can  also  serve  as  a  hot  button  to 
"drill  down"  and  explore  the  reasons  for  the  particular  color 
coding. 

While  the  user  is  viewing  any  of  the  DTIC-EIS  screens,  that 
screen  may  be  printed,  using  the  standard  "Print  Screen"  function 
of  the  workstation.  Specialized  printing  requirements  may  call 
for  technical  assistance.  Rarely,  the  DTIC-EIS  application  will 
encounter  a  fatal  error.  This  is  most  often  indicated  by  a 
message  in  red  letters  along  the  bottom  line  of  the  screen  and  a 
shift  of  the  cursor  to  the  upper  left  corner  of  the  screen,  next 
to  a  question  mark  (?) .  If  possible,  the  red  letter  message 
should  be  recorded  and  reported  to  EIS  technical  support  staff. 
The  situation  can  be  overcome  by  typing  "call  go"  at  the  ?  and 
pressing  the  "enter"  key.  (Do  not  include  the  ""  when  typing 
call  go.)  If  all  else  fails,  the  entire  Pilot  process  may  be 
terminated  by  simultaneously  pressing  the  "Alt"  and  "F10"  keys. 
This  is  an  inelegant  and  ungraceful  way  to  exit  the  DTIC-EIS. 
The  preferred  approach  is  to  use  the  appropriate  hot  buttons  on 
the  DTIC-EIS  screens. 
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Pilot  perforins  periodic  communications  checks  between  the 
Host  computer  and  the  Workstation.  Sometimes  a  correctable 
communications  error  may  occur.  Pilot  uses  a  small  box  in  the 
lower  right  hand  portion  of  the  screen  to  inform  you  when  such  an 
event  happens.  The  box  contains  the  letters  "ERR. "  There  is  no 
reason  to  be  concerned  about  this  error  indicator,  unless  other 
symptoms  are  also  present.  You  may  turn  the  indicator  off  by 
pressing  any  of  the  keyboard  LOCK  keys  (CAPS,  NUM,  SCROLL). 
Notice  that  each  of  these  keys  has  its  own  indicator  box  on  the 
screen.  You  may  also  ignore  the  presence  of  the  ERR  box.  Con¬ 
tact  your  technical  ElS/communications  support  staff,  if  you  feel 
there  is  a  more  serious  problem  with  the  communications  at  your 
particular  workstation. 

Additional  user  instructions  may  be  found  in  the  Pilot 
Manual,  "The  Personal  Computer  Operations  Guide." 
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B:  A  tour  of  DTIC  EIS  Screens. 


This  is  the  main  DTIC-EIS  screen.  It  provides  three  hot 
buttons  for  access  to  the  three  principle  components  of  the  DTIC 
application.  Personnel,  Financial  and  Summary  Management  Data 
Report  ( SMDR) .  There  are  also  two  utility  buttons,  Logout  and 
Jump,  on  the  next  to  the  last  line  of  the  screen.  The  Logout 
button  is  the  preferred  method  of  terminating  the  DTIC-EIS.  Also 
note  the  three  buttons  on  the  last  line.  These  are  simply  indi¬ 
cator  lights,  corresponding  to  similar  lights  on  most  keyboards 
that  show  the  status  of  "scroll  LOCK",  "NUM  lock",  and  "CAPS 
lock."  The  space  between  "LOCK"  and  "NUM"  is  used  by  Pilot  to 
indicate  a  temporary  error  condition  with  the  "ERR"  light. 


Click  on  the  JUMP  button! 
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Executlue  Infornatlon  Systen 


The  JUMP  button  appears  on  most  DTIC-EIS  screens.  It  pro¬ 
vides  a  convenient  way  to  branch  to  various  sections  of  the 
application  without  returning  to  the  main  screen.  The  PERSON  and 
POSITION  buttons  are  special  features  of  the  personnel  applica¬ 
tion.  The  CHECKBOOK  button  is  equivalent  to  clicking  on  the 
FINANCIAL  button  on  the  main  screen.  The  TRANSACTION  and  AUTHOR¬ 
IZATION  buttons  are  special  features  within  the  financial  appli¬ 
cation.  The  SMDR  button  is  equivalent  to  the  SUMMARY  MANAGEMENT 
DATA  REPORT  button  on  the  main  screen.  The  RETURN  button  clears 
the  Jump  selections  and  returns  you  to  the  underlying  screen,  in 
this  case  it  would  be  the  main  screen. 

Click  SMDR! 
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This  is  the  SMDR  selection  screen.  Clicking  on  any  category 
in  the  left  column  produces  the  appropriate  list  of  tables  in  the 
right  column.  Note  the  date  in  the  upper  right  corner,  this  is 
the  date  of  the  most  recent  data  upload  to  the  system.  Also, 
note  the  utility  buttons  at  the  bottom  of  the  screen.  BACK  ONE 
will  return  you  to  the  screen  which  you  were  viewing  immediately 
prior  to  the  current  one.  RETRACE  will  present  a  specialized  set 
of  utilities  and  options  in  the  form  of  a  full  sized  screen. 


Click  RETRACE! 
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You  may  click  on  UP  ONE  and  obtain  the  equivalent  results  of 
using  the  BACK  ONE  button  which  was  explained  on  the  last  screen. 
You  may  also  select  (click  on)  any  of  the  screens  listed  in  the 
main  part  of  the  retrace  screen.  This  list  represents  an  histor¬ 
ical  trail  of  the  previous  screens  which  you  have  been  viewing. 
In  effect,  you  can  go  directly  back  to  any  previous  screen  which 
still  appears  on  the  retrace  list.  From  time  to  time,  the  re¬ 
trace  list  is  replaced  by  a  new  sequence,  as  determined  by  the 
program  logic.  The  UTILITIES  button  presents  another  "pop-up" 
menu,  similar  to  the  JUMP  button. 


Click  UTILITIES! 
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Retrace  Heim 

toP  HEMU 

©TIC  SHDR  PROTOTVPE  (HAIR IS)  HANPOUER  AMD  IRAIHIHG  RESEARCH  1NF0RHAI10H  SYSTEM 

DIIC  SHDR  PROTOTVPE  TECHNICAL  REPORTS  PG1  SHDR  INDEX 

Change 

Passuord 

Edit  Pay  Table 

FLUSH  RETURN 

1™ 

Utilities 

The  FLUSH  button  clears  the  retrace  history  list  and  returns 
you  to  the  main  screen.  You  may  sometimes  wish  to  use  this 
function  to  insure  that  the  workstation  has  not  retained  some  old 
versions  of  data  screens  which  you  no  longer  want  to  see.  The 
most  logical  reason  and,  in  fact,  the  only  necessary  reason  for 
FLUSHing  is  after  editing  new  data  onto  one  of  the  many  screens 
with  such  capability.  In  such  a  case,  the  FLUSH  will  assure  that 
you  see  your  new  data,  the  next  time  that  screen  is  displayed. 
The  RETURN  button  sends  you  back  to  the  retrace  screen.  CHANGE 
PASSWORD  provides  access  to  the  VMS  utility  for  resetting  your 
MicroVax  password. 

Click  on  CHANGE  PASSWORD! 
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)ld  passuord 
feu  passuord 
Verification 


The  system  will  request  your  old  password  and  then  ask  for 
your  new  one.  The  verify  step  insures  that  you  do  not  make  a 
typographical  error  in  entering  your  new  password.  None  of  the 
keys  which  you  press  will  be  echoed  onto  the  screen  for  security 
reasons.  When  you  have  completed  the  three  step  process,  you 
will  be  automatically  returned  to  the  previous  retrace  screen. 

Click  EDIT  PAY  TABLE! 
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This  utility  provides  a  means  of  data  entry  into  tables  that 
are  not  otherwise  visible  in  the  DTIC-EIS  application.  Notice 
the  Question  mark  (?)  in  the  upper  right  corner.  This  is  a  HELP 
button.  Clicking  on  it  will  toggle  all  of  the  buttons  on  the 
screen  from  their  normal  action  to  display  short  explanations  of 
their  function.  Click  HELP  again  to  turn  the  toggle  off  and 
resume  normal  operation.  See  the  Pilot  Manual,  "Enter-View 
User's  Guide",  for  more  detailed  instructions.  Click  on  RETURN 
and  observe  the  instructions  on  the  bottom  line  of  the  screen  to 
select  (i.e.  click  the  left  mouse  button)  again.  This  will 
return  you  to  the  retrace  screen. 


Click  on  the  last  line  in  the  retrace  list  to  return  to  the 
SMDR  selection  screen.  Click  DESIGN  COMMENTS! 
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Sunnary  fldiiayeneiit  Data  Report 

CATEGORY 

DTIC  SNDR  PROTOTYPE 

9/89 

TABLE 

I  TECHNICAL  REPORTS 
IDATABA3E  Collection 
liJuD  Snail  Business 

Idfols 

1  INDEPENDENT  RSD 
iPfilNT JNG  PLANT 
IPROGNAH  SU11MARV 
IqUALITY  ASSURANCE 
ltNATRIS)  MANPOWER  AND 
|UORK  UNIT  INFORNATION 


DTIC  SNDR 


9uto  Doc  Dist  Subscripts 
Bib  Database  Retrieval 
Deiwud  Orders  Processed 
DmiriSvrs  InHoiise  TR  Bibs 
1AC  Neu  Records 
leu  Record  Collection 
Reports  Distributed 
Special  Document  Process 
ST  INFO  Reference  Sues 
Tecli  Screen  Sruy  Exenpt 
Tecli  Screen  Sruy  Rev  i  cud 
Tecli  Screen  Sruy  U2  Rpts 
PROTOTYPE  TECHNICAL  REPORTS  PG1  SNDR  INDEX 


Type  your  connents  on  these  three  lines,  111 


83  Press  enter  uhen  done , 


♦ 

I^^VTanceT" 

our  contents  or  CANCEL  to  abort 

This  opens  up  a  text  entry  box  where  the  user  may  send 
messages  to  the  EIS  design  team.  It  is  important  to  use  this 
feature  often  and  freely,  with  frank  comments  about  the  system 
and  how  you  think  it  could  be  improved.  Type  in  your  comments  on 
the  three  lines  provided  and  press  the  enter  key.  You  now  have 
three  buttons  to  choose  among.  You  may  click  on  the  text  box  to 
revise  your  comments,  click  on  CANCEL  to  ignore  your  comments  or 
click  RETURN  to  record  them  in  the  developer's  log  file. 

Either  RETURN  or  CANCEL  will  remove  the  pop-up  window  and 
give  you  access  to  the  full  SMDR  selection  screen.  Click  on  any 
Table  from  the  list  on  the  right! 
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TECHNICAL  REPORTS 
Bib  Database  Retrieval 


9/89 
EDIT  S 


This  is  the  principle  SMDR  data  presentation  screen.  Note 
the  buttons  in  the  upper  left.  Columns  1-7  are  shown  on  "page  1" 
and  columns  8-14  on  "page  2."  You  may  also  switch  to  the  corre¬ 
sponding  data  set  for  other  years.  The  EDIT  button  in  the  upper 
right  is  a  toggle  switch.  When  EDIT  is  "on",  you  may  enter  new 
or  revised  data,  directly  into  the  data  base.  This  can  be  tricky 
at  times.  You  may  need  to  use  the  retrace  screen's  utility  and 


FLUSH  the  old  version  of  this  screen  before  you  will  see  your  new 
entries  properly  displayed.  You  must  turn  EDIT  "off"  before 
proceeding.  The  GRAPH  button  in  the  upper  right  allows  you  to 
select  among  several  types  of  graphical  displays.  These  graphs 
display  predetermined  formats  in  a  standardized  way.  User  cus¬ 
tomized  displays  are  addressed  later  in  the  WORKSHEET  feature. 
The  RETRACE,  BACK  ONE,  JUMP,  and  DESIGN  COMMENTS  buttons  are  as 
before.  Click  on  FOOTNOTES! 
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If  any  footnotes  apply  to  this  data  set,  they  will  be  dis¬ 
played  here.  You  may  page  through  the  footnote  file  using  the 
buttons  on  the  right.  As  with  all  editing  features  of  the  DTIC 
EIS,  you  must  have  appropriate  permissions  to  use  the  feature. 
When  adding  or  editing  text  data,  you  are  automatically  trans¬ 
ferred  to  the  host  computer's  text  editor.  (The  special  control 
keys  for  using  the  VAX  EDT  Text  Editor  are  found  on  page  B-7  of 
the  Pilot  Personal  Computer  Operations  Guide.)  The  RETURN  button 


sends  you  back  to  the  data  screen. 


Click  RETURN! 


Once  you  are  back  viewing  the  data  screen,  click  WORKSHEET! 
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This  provides  the  means  for  you  to  select  any  of  the  seven 
displayed  columns  of  data  by  clicking  on  the  column's  title  in 
the  pop  up  window.  You  may  also  select  the  average  monthly  level 
for  the  programmed  activity  of  any  column  by  clicking  on  the 
appropriate  program  button.  If  you  click  on  RETURN,  you  will  go 
back  to  the  data  screen. 


Click  on  GO  TO  WORKSHEET! 


For  full  details  on  the  operation  of  the  worksheet  utility, 
see  the  Pilot  Manual,  "Worksheet,  Retrace,  and  Electronic  Paper¬ 
clip  User's  Guide."  The  ?  in  the  upper  right  is  another  help 
toggle.  You  may  select  data  sets  from  various  SMDR  screens  to 
place  on  the  Worksheet.  Then  you  may  select  any  combination  of 
them  for  graphing  or  use  the  calculator  for  creating  special  data 
combinations.  Also  notice  the  special  utility  buttons  at  the 
bottom  of  the  screen. 


Click  RETURN!  To  get  back  to  the  SMDR  data  screen. 
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Each  button  in  the  YTD  row  will  produce  an  individual  graph 
of  that  column  of  data,  including  the  monthly  program  levels,  ac¬ 
cording  to  the  format  which  you  specified  in  the  GRAPH  button. 


Click  the  left  mouse  button  to  return  to  the  data  screen. 
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TECHNICAL  REPORTS 
Bib  Database  Retrieval 
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The  buttons  in  the  program  row  all  produce  the  same  graph 
which  shows  one  line  for  each  column  of  data.  No  program  levels 
are  displayed. 


Click  the  left  mouse  button  to  return  to  the  data  screen. 


This  completes  the  tour  of  the  SMDR  application.  We  will 
now  look  at  the  Financial  application.  We  can  start  it  by  either 
using  the  JUMP  button  and  clicking  on  CHECKBOOK  or  by  going  to 
RETRACE  and  picking  the  TOP  screen  on  the  list  and  then  clicking 
on  the  middle  box,  FINANCIAL.  These  two  alternatives  are  equiva¬ 
lent. 
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Our  four  standard  utility  buttons  are  at  the  bottom.  We 
also  have  the  "as  of"  date  in  the  upper  right.  In  the  upper  left 
is  the  HELP  button.  This  is  the  same  concept  as  described  earli¬ 
er,  however  help  files  have  not  yet  been  established  for  the  main 
part  of  the  DTIC  EIS.  The  CLEAR  button  erases  any  entries  in  the 
four  left  boxes.  SHOW  SUBORDINATES  is  a  special  data  modifier; 
"YES"  means  that  the  lowest  office  level  available  will  be  dis¬ 
played,  "NO"  aggregates  the  data  at  the  highest  office  level. 

Click  on  LIST  CHOICES  in  the  object  class  box! 
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Equipnent 

♦ 

1  ■iii'.  CM  Kdl  1 

The  pop  up  window  allows  you  to  select  any  one  item  from  the 
list.  When  you  click  on  it,  it  will  automatically  fill  in  the 
box  on  the  selection  screen.  Notice  the  self  explanatory  control 
buttons  for  searching  the  pop  up  list.  CLEAR  returns  you  to  the 
selection  screen  and  erases  whatever  entry  you  had  in  that  box. 


Click  on  24  from  the  Object  Class  list! 


Click  LIST  DATA  in  the  PROJECT  NUMBER  box. 
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The  display  shows  Project  Number  in  the  left  column,  because 
that  is  what  we  requested.  The  data  is  the  group  which  meets  all 
of  the  criteria  which  we  filled  in  on  the  selection  screen. 
Here,  our  only  limitation  was  Object  Class  24.  Note  the  HELP,  as 
of  date  and  graph  selection  buttons  as  described  earlier.  The 
page  control  is  self  explanatory.  The  TOTAL  line  represents  the 
total  of  all  selected  data,  not  just  the  portion  that  appears  on 
any  one  page. 

Click  GRAPH  on  the  bottom  to  see  the  graph  form  which  you 
specified  above! 
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Authorization 


Committed 


Click  SELECT  (left  mouse)  to  return  to  the  data  display. 


Click  on  711.06  in  the  left  column! 


39 


Transaction  Details 

OBJECT  CLASS  is  24  and  PROJECTJCODE  is  711.06 


9/89 


This  produces  a  "drill  down"  effect.  We  now  see  the  indi 
vidual  transaction  list  for  this  Project  Code. 


Click  on  DIRECTORY  in  the  Description  column! 
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This  is  the  lowest  drill  down  level  in  the  transaction  file. 


This  shows  all  of  the  detailed  information  about  the  specific 


transaction. 


Use  RETRACE  to  get  back  to  the  Checkbook  selection  screen. 

Imaginative  use  of  this  screen  can  be  very  powerful.  For 
example,  several  different  DTIC  wide  summaries  can  be  produced  by 
not  making  any  selection  and  clicking  on  the  LIST  DATA  buttons  in 
the  boxes  on  the  left. 

Click  on  SHOW  DATA  at  the  bottom  of  the  screen! 
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Notice  the  three  columns  of  descriptive  data  on  the  left. 
This  is  more  specific  than  the  single  column  that  comes  from  a 
LIST  DATA  click.  You  can  drill  down  from  this  screen  as  before. 


click  JUMP!  click  TRANSACTION! 
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This  is  another  of  the  powerful  selection  screens  provided 
by  the  DTIC  EIS.  This  screen  allows  you  to  specify  the  criteria 
for  selecting  a  custom  group  of  transactions.  The  functions  of 
the  active  buttons  on  this  screen  have  been  described  on  previous 
screens.  The  notable  new  item  on  this  screen  is  the  transaction 
count  box  in  the  upper  center  of  the  screen.  In  this  example, 
there  are  2342  transactions  from  the  DTIC  Commitments  and  Obliga¬ 
tions  (C&O)  Ledger,  as  of  9/89. 


Click  on  TYPE  in  the  Product  Number  box  and  fill  in  Product 
Number  730.  Press  the  enter  key  or  left  mouse  button  to  complete 


the  entry. 
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Notice  that  this  entry  has  reduced  the  selected  number  of 


transactions  to  76. 


Click  SHOW  DATA! 
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This  is  the  same  format  as  the  screen  to  which  we  were  able 
to  "drill",  starting  from  the  CHECKBOOK  screen.  Notice  that  the 
TOTAL  line  provides  an  aggregation  for  all  of  the  transactions 
which  were  SELECTED  on  the  previous  screen.  This  time  we  were 
able  to  arrive  at  this  screen  more  directly  and  more  quickly,  but 
we  have  also  obtained  more  detail.  If  you  need  the  detail,  then 
this  is  a  good  approach.  If  you  only  need  the  summary  level 
aggregations,  then  the  CHECKBOOK  approach  is  better.  The  count 
information  from  the  selection  screen  and  the  total  dollar 
amounts  on  this  detail  screen  are  very  potent  tools,  limited  only 
by  the  imagination  of  the  user. 

Click  JUMP!  Click  AUTHORIZATION! 
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.lit, nr  in  t,ln:  Unlne 


Here  we  have  another  selection  screen.  The  operation  of  the 
AUTHORIZATION  selection  screen  is  similar  to  the  CHECKBOOK  and 
TRANSACTION  selection  screens.  Only  the  subject  matter  is  dif¬ 
ferent.  The  purpose  of  this  section  of  the  DTIC  EIS  is  to  manage 
and  track  authorizations  and  their  periodic  changes  throughout 
the  year. 


Use  TYPE  to  enter  24  in  the  Object  Class  selection  box. 
Notice  that  there  are  two  authorizations  in  this  object  class. 


Click  CLEAR! 
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Use  TYPE  to  enter  L  in  the  Office  selection  box. 
that  there  are  nine  authorizations  in  this  group. 


Click  SHOW  DATA! 


Notice 
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This  screen  shows  the  quarterly  authorization  levels  for  the 
nine  object  classes  used  by  the  office  "L. " 


Click  on  one  of  the  rows,  by  using  the  hot  buttons  in  the 


left  column.  This  will  "drill  down"  to  a  more  detailed  view  of 


this  particular  authorization. 
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Click  on  the  EDIT  button  in  the  upper  right.  For  those 
users  who  have  been  granted  permission,  the  data  on  the  screen 
can  now  be  modified.  Notice  that  we  store  the  information  at  a 
monthly  level  of  detail.  When  all  of  the  changes  have  been  made, 
clicking  on  UPDATE  will  add  an  additional  entry  to  the  history 
file  for  this  authorization.  Clicking  on  NEW  RECORD  will  create 
a  similar  record  for,  for  example,  a  new  organizational  element. 
When  editing  is  complete,  you  must  turn  EDIT  off  by  clicking  on 
it  one  more  time. 


Click  HISTORY! 
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ization  changes  which  have  been  recorded,  to  date,  for  this 
particular  authorization. 


This  completes  the  overview  of  the  Financial  application. 
Use  the  RETRACE  button  to  return  to  the  TOP  screen.  Then,  click 
on  PERSONNEL! 
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The  Personnel  application  begins  with  a  organization  chart. 
There  are  several  familiar  buttons  on  this  screen.  They  function 
in  the  same  manner  as  described  for  the  other  applications.  The 
UP  ONE  button  acts  to  move  your  view  of  the  Organization  to  the 
next  higher  hierarchical  level.  Note  the  distinction  from  the 
BACK  ONE  button  which  sent  you  back  to  the  previous  screen.  You 
may  "drill  down”  into  the  organization  by  clicking  on  the  any 
desired  office  symbol. 

The  STAFF  box  in  the  upper  right  corner  will  show  DTIC 
totals,  on  this  top  screen  only.  On  other  screens,  the  staff 
box  will  provide  information  on  the  headquarters  element  of  the 
Office  shown  in  the  top  center  box. 

Click  on  any  of  the  PEOPLE  buttons! 
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Here  we  see  a  listing  of  all  of  the  people  assigned  to  the 
Office  which  we  selected  above.  Note  that  there  is  an  edit 
capability  for  this  screen.  This  function  could  be  used  to 
maintain  the  data  base,  but  at  present,  it  is  not.  Any  EDIT 
entries  will  remain  in  the  file  until  the  next  data  base  transfer 
from  the  "official"  personnel  file  maintained  by  DTIC-LRE. 


Click  on  any  of  the  names  in  the  left  column  to  obtain 
additional  details  about  that  person. 
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This  is  the  person  detail  screen.  Notice  that  it  too  may  be 


edited,  at  least  for  an  interim  period.  There  should  be  strict 
controls  placed  on  the  viewing  and  editing  of  this  screen,  par¬ 


ticularly  the  information  related  to  pay  rates. 


Click  on  the  content  of  the  TITLE  field.  This  will  take  you 
to  full  details  about  the  Position  which  this  person  occupies. 
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Position  Listing  2 
OPER  RESEARCH  ANAL 


9/89 


Now  we  can  see  the  full  details  about  the  Position,  includ¬ 
ing  a  list  of  all  the  People  who  are  assigned  to  this  Position. 
In  the  above  example,  we  have  a  vacancy  and  the  Position  only 
calls  for  one  ’’slot."  For  positions  with  multiple  slots  recog¬ 
nized,  the  list  on  the  right  would  be  longer.  You  may  click  on 
the  name  of  any  person  on  the  list  to  obtain  the  details  about 
that  person. 


Click  COST  ESTIMATES! 
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This  screen  shows,  by  month,  the  estimated,  authorized  and 


actual  costs  of  the  position  or  group  of  positions  which  were 


selected.  Currently,  DTIC  only  maintains  actual  personnel  costs 


at  the  Directorate  Level.  At  lower  levels,  as  in  the  example 
above,  the  columns  may  not  all  be  filled.  You  may  wish  to  ex¬ 


plore  several  of  these  screens  to  get  the  full  impact  of  their 
potential . 


The  FIRST  ESTIMATE  column  reflects  the  estimated  cost,  if 
all  recognized  "slots"  for  this  position  were  filled  at  the  mid 
step  of  the  recognized  grade.  This  is  determined  by  applying  the 
benefit  rate  for  the  office  to  which  this  position  belongs  to  the 
calculated  salary  total.  Special  categories,  such  as  night 
differential,  are  not  considered  in  this  estimate. 
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The  INCUMBENT  and  SF-52  columns  reflect  the  precise  (to  the 
day)  estimates  for  each  group.  For  INCUMBENTS,  special  and 
normal  pay  rates  are  determined  from  tables  and  multiplied  by 
eight  hours  per  weekday  in  that  month.  With-in-grade-increases 
(WIGI)  and  scheduled  departures  are  considered  and  the  appropri¬ 
ate  benefit  rate  added.  For  SF-52s,  the  predicted  start  date  for 
a  mid-step  employee  is  used,  plus  benefits.  WIGI  and  special 
rates  are  not  considered. 

The  BEST  ESTIMATE  column  adds  the  INCUMBENT  and  SF-52  col¬ 
umns  and  applies  the  attrition  rate  for  the  particular  office. 
Attrition  and  benefit  rates  for  each  office  appear  on  the  organi¬ 
zational  chart  screen,  when  that  office  is  in  the  top  center  box. 
Each  office  may  have  its  own  rates  or  automatically  inherit  the 
rates  of  its  parent  organization.  The  rates  may  be  changed  using 
the  EDIT  feature  on  the  organizational  chart  screen. 

Note  the  GRAPH  and  FOOTNOTE  buttons  which  function  the  same 
way  as  described  for  previous  screens.  Select  the  GRAPH  TYPE 
"AREA"  and  click  on  GRAPH! 
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This  is  one  example  of  Personnel  Cost  Graphs.  Press  the 
left  mouse  button  to  return  to  the  previous  screen. 


Use  RETRACE  or  a  series  of  BACK  ONE  clicks  to  return  to  the 
organizational  chart  screen.  Then.... 

Click  on  any  of  the  POSITION  buttons! 
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This  is  a  listing  of  all  of  the  positions  in  the  organiza¬ 
tion  which  you  selected.  The  list  may  be  more  than  one  page 
long.  This  list  is  similar  to  the  list  of  people,  which  we 
reviewed  earlier. 


Clicking  on  any  of  the  title  descriptions  in  the  TITLE 
column  will  take  you  to  the  position  detail  screen,  as  we  saw 
before. 

Click  one  of  the  entries  in  the  COST  YTD  column! 
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This  is  the  same  personnel  cost  format  which  we  saw  for  an 
individual  position.  This  time,  however,  it  reflects  the  costs 
of  a  group  of  positions.  Since  we  chose  a  Directorate  level 
example,  the  Authorization  column  is  filled.  In  the  future  the 
actual  column  (Committed  &  Obligated)  will  be  filled.  This 
provides  the  baaxs  for  calculating  the  DELTA,  or  difference 
between  authorized  and  actual.  The  sum  of  the  DELTA  column, 
shown  in  the  lower  right  is  the  most  important  number  on  this 
screen.  It  reflects  the  projected  end  of  year  status  of  this 
organization's  personnel  budget. 

Click  JUMP!  Click  PERSON. 
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This  is  another  of  the  powerful  DTIC  EIS  Selection  screens. 
Notice  the  "Current  Number  of  People"  in  the  top  center  of  the 
screen.  This  is  the  number  of  "records"  in  the  employee  data 
file.  Most  of  these  are  actual  names,  but  some  are  just  place 
holders,  usually  with  the  word  "Vacancy"  in  place  of  an  actual 
name.  The  buttons  function  as  previously  described  for  other 
screens.  This  screen  permits  the  selection  of  any  ad  hoc  group 
of  employees.  Clicking  on  SHOW  DATA  will  lead  to  a  Person  list 
as  we  have  seen  before. 


Click  JUMP!  Click  POSITION! 
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This  is  the  final  screen  in  our  tour.  It  is  also  a  selec¬ 
tion  screen.  This  time  for  positions.  The  "Current  Number  of 
Positions"  represents  the  number  of  different  positions.  Many  of 
these  have  multiple  "recognized  slots."  The  POSITION  DATA  will 
lead  to  a  Position  list  screen,  as  before.  The  COST  DATA  will 
lead  to  a  cost  screen  for  the  selected  group  of  positions.  Any 
idea  how  much  all  of  the  positions  in  your  series  are  costing 
DTIC  each  year? 

Note  that  these  last  two  selection  screens  permit  choices 
across  organizational  lines  and  other  boundaries.  That  is  a  key 
difference  from  the  PEOPLE  and  POSITION  buttons  on  the  organiza¬ 
tional  chart  screens. 
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C:  Postlude . 

The  DTIC  EIS  provides  many  BENEFITS.  Some  of  them  are 
listed  below. 

Quick,  easy  access  to  information. 

Up-to-data  information. 

Relevant  information. 

Accurate  information. 

Product  (unit)  cost  capability. 

Project  cost  account  reports. 

Trend  reporting  capability. 

Graphs  and  charts  readily  available. 

Drill  down  capability. 

Eliminate  time  consuming  manual  work  ups. 

SMDR  faster. 

Checkbook  faster. 

Paper  reduction. 

Historical  statistics. 

Present  MMR  &  PRRE  program  statistics. 

Access  to  new  information. 

Quick  counts  on  personnel,  positions  or  transactions. 

Better  cooperation  when  we  all  use  the  same  data. 

Data  errors  more  quickly  located,  when  data  is  shared. 

Point  &  click  friendly  user  interface  to  DTIC  EIS. 
Authorization  history  tracking. 

Personnel  costing  model  on-call  vs.  annual  guesstimate. 
Integration  of  budget,  personnel  and  workload  statistics. 
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The  DTIC  EIS  is  far  from  complete.  The  project  team  has 
developed  a  long  list  of  ideas  for  enhancement  and  improvement. 
You  are  encouraged  to  use  the  DESIGN  COMMENTS  button  freely  and 
frequently  to  add  your  comments  and  suggestions. 

The  key  to  DTIC  EIS  success  is  ACrlVis  use  of  the  system  by 
anyone  who  can  benefit  from  it.  You,  the  users,  will  then  make 
the  DTIC  EIS  fit  your  needs.  EIS  users  and  advocates  must  be 
proactive  bridge  builders  to  overcome  the  obstacles  created  by 
the  occasional  wall  builder. 
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SECTION  III-TECHNICAL . 


The  following  document  describes  the  organization  of  the 
DTIC  EIS.  It  presumes  a  working  knowledge  of  Pilot's  Com¬ 
mand  Center  language,  DEC'S  VMS  command  language,  MS  DOS 
and  elementary  structured  programming  techniques. 

1 .  What  is  Command  Center? 

The  Defense  Technical  Information  Center  Executive 
Information  System  (DTIC  EIS)  is  implemented  with  a  product 
called  Command  Center  from  a  company  named  Pilot.  This 
product  allows  applications  to  be  built  that  present  a 
mouse  driven  user  interface  on  an  IBM  PC  or  compatible  (EIS 
PC)  that  is  linked  via  an  asynchronous  communications  link 
to  a  Digital  Equipment  Corporation  computer  running  the  VMS 
operating  system  (EIS  Host) .  Command  Center  consists  of  a 
command  interpreter,  a  forms  editor,  a  data  manipulation 
language,  a  compiler,  a  communications  tool  for  the  VMS 
host  and  an  executable  file  for  the  PC  that  performs  graph¬ 
ics  and  communication  functions. 

2.  What  are  the  components  of  this  EIS  application? 

This  EIS  application  consists  of  a  database  and  a 
graphic  user  interface  to  present  and  manipulate  that  data. 
The  database  is  stored  on  the  EIS  Host  in  the  form  of 
several  Pilot  tables.  The  data  is  displayed  on  screen 
forms  or  menus  whose  descriptions  are  stored  on  the  EIS 
Host  in  menu  files.  Procedures  stored  on  the  EIS  Host  fill 
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the  menus  with  data  from  the  database  and  control  naviga¬ 
tion  through  the  application. 

2.1.  How  is  this  application  organized? 

The  source  code  for  the  application  is 
divided  into  two  different  catalogs.  The  DTIC2  catalog 
contains  the  executing  system  and  data  tables.  The 
TOOLS  catalog  contains  the  procedures  to  update  the  data 
and  other  auxiliary  code.  A  third  catalog,  DTIC2TEXT, 
contains  the  footnotes  to  the  Summary  Management  Data 
Report  screens.  There  are  two  Pilot  applications  embed¬ 
ded  within  the  DTIC  application.  The  Worksheet  allows 
you  to  perform  ad  hoc  graphs  and  mathematical  calcula¬ 
tions.  Enterview  is  used  for  editing  of  the  pay  table. 
These  two  applications  do  not  follow  all  of  the  conven¬ 
tions  outlined  below. 

2.2.  What  are  the  Types  of  Files? 

2.2.1.  Menus . 

Menus  are  screen  images  or  forms  that  can  be 
displayed  on  the  EIS  PC.  Menus  are  a  more  advanced 
form  of  the  traditional  database  form.  Command 
Center's  menus  can  display  any  printable  character 
in  the  AS^TI  character  set.  Menus  are  created  with 
a  tool  provided  by  Pilot  called  1  Menu  Editor. 
There  are  three  different  types  or  menus  in  this 


65 


application  based  on  the  amount  of  information 
needed  to  invoke  them.  The  retrace  screen  does  not 
require  any  data.  To  call  a  selection  screen,  only 
the  time  period  of  interest  is  needed.  The  data 
screens  require  a  database  reference  that  specifies 
the  data  to  be  displayed  in  addition  to  the  date. 

2.2.2.  Procedures . 

This  application  contains  several  different  types 
of  procedures.  There  are  procedures  to  fill  menus 
with  data,  control  the  navigation  between  menus, 
display  graphs,  import  new  data,  and  perform  utility 
functions.  Procedures  are  written  in  a  fourth  gen¬ 
eration  like  code  that  is  proprietary  to  Pilot  and 
are  then  compiled  with  Pilot's  compiler  into  an 
intermediate  form.  This  intermediate  form  is  then 
interpreted  at  run  time. 

2.2.3.  Data  Tables . 

The  DTIC  EIS  application  has  over  a  dozen  tables. 
There  are  tables  for  storing  information  about  peo¬ 
ple,  organizations,  money  spent,  and  budgets.  Tables 
are  createa,  updated,  referenced  and  destroyed  by 
Command  Center  commands.  These  commands  can  be 
issued  directly  to  the  interpreter  or  can  be  assem¬ 
bled  into  procedures.  Pilot  does  not  consider  Com¬ 
mand  Center  to  be  a  relational  database.  Therefore, 
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their  product  does  not  contain  all  of  the  func¬ 
tionality  that  is  expected  of  a  database  management 
system. 

2.2.4.  Text  Files. 

This  application  includes  several  text  files. 
These  are  ASCII  files,  maintained  on  the  EIS  Host, 
that  contain  textual  comments  about  various  sub¬ 
jects.  These  files  consist  mainly  of  footnotes  to 
the  Summary  Management  Data  Report  screens. 

2.3.  How  does  the  Control  Flow? 

The  DTIC  EIS  application  code  is  structured  in  an 
object  oriented  manner.  The  basic  object  in  this  appli¬ 
cation  is  the  screen  image  or  menu.  All  of  the  screens 
can  be  called  from  anywhere  else  and  are  not  history 
sensitive.  This  allows  the  control  to  flow  between  dif¬ 
ferent  screens  in  a  directed  graph  manner  instead  of  the 
typical  rooted  tree  structure.  The  standard  flow  of  con¬ 
trol  to  run  a  typical  menu  is  as  follows. 

2.3.1.  Run  Menu . 

The  user  takes  an  action  which  initiates  a  run 
menu  command  (Either  from  the  command  line  or  by 
selecting  a  button  on  an  active  menu) .  At  this  time 
the  following  parameters  are  passed  to  the  menu: 
Current  Month,  Current  Year,  Title,  Database  Refer¬ 
ence,  Page,  Return  Menu. 
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2.3.2.  Call  Fill  Procedure. 


The  menu  then  calls  a  procedure  named  FILL*.  This 
procedure  takes  the  same  parameters  as  the  run  menu 
call.  This  procedure  will  then  perform  the  follow¬ 
ing  steps: 

2. 3. 2.1.  Determine  if  This  is  a  Cached  Menu. 

Determine  if  this  is  a  cached  menu  and  if  so 
recall  any  auxiliary  information  from  the  blind 
cells,  add  its  name  to  the  retrace  list  and 
return  to  the  initial  actions  of  the  calling 
menu . 


2. 3. 2. 2.  Check  if  There  is  a  Cached  Version  of 
the  Current  Menu. 

Check  to  see  if  a  cached  version  of  this  menu 
with  this  data  on  this  page  exists  and  if  so, 
return  its  name  in  the  return  menu  variable. 

2 . 3 . 2 . 3 .  Retrieve  Data . 

Query  the  database  and  retrieve  the  data 
indicated  in  the  data  reference  variable. 

2 . 3 . 2 . 4 .  Format  Data . 

The  data  is  then  formatted  and  displayed. 
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2 . 3 . 2 . 5 .  Save  Parameters  in  Blind  Cells . 


The  parameters  passed  into  this  procedure  and 
auxiliary  information  is  stored  in  blind  cells. 

2 . 3 . 2 . 6 .  Include  in  Retrace . 

A  procedure  is  called  to  include  the  current 
menu  in  the  retrace  list. 

2 . 3 . 2 . 7 .  Cache  Current  Menu . 

Finally,  the  current  screen  image  is  assigned 
a  name  and  cached.  Control  is  returned  to  the 
initial  action  of  the  menu. 

2.3.3.  Run  Cached  Menu  If  Exists . 

If  the  fill  procedure  returned  the  name  of  an 
existing  cached  menu,  then  the  cached  menu  is  run 
with  the  parameters  passed  into  the  original  menu. 

2.3.4.  Wait  For  User  Input . 

Control  is  then  passed  to  the  user.  The  user  can 
then  select  one  of  three  different  types  of  buttons. 

2. 3. 4.1.  Link  Buttons. 

Link  buttons  are  buttons  that  lead  to  other 
application  screens.  They  use  the  following  con¬ 
trol  logic: 
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2. 3. 4. 1.1.  Retrieve  Values  From  Blind  Cells. 

First,  gather  the  necessary  control  infor¬ 
mation  from  the  blind  cells  and  the  cell  that 
was  selected. 

2. 3. 4. 1.2.  Verify  Data  Exists. 

Next,  some  button  actions  verify  if  there 
is  data  for  the  next  screen  that  will  be 
called  and  abort  if  not. 

2 . 3 . 4 . 1 . 3  .  Run  Mew  Menu . 

Finally  the  new  menu  is  run. 

2 . 3 . 4 . 2 .  Graph  Buttons 

Graph  buttons  are  buttons  that  call  pro¬ 
cedures  to  graph  the  data  currently  on  the 
screen.  Most  graph  buttons  just  call  the  graph 
procedure  and  let  it  fetch  all  the  necessary 
information  from  the  screen. 

2 . 3 . 4 . 3 .  Control  Buttons . 

Control  buttons  change  the  state  of  the 
current  screen.  They  are  used  to  toggle  between 
graph  types,  to  toggle  help  and  edit  features  on 
and  off,  to  change  values  when  editing,  and  to 
save  edit  changes. 
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3.  How  is  the  Data  Updated. 

3.1.  Overview . 

3.1.1.  Source  Data  Files . 

Several  different  tools  are  utilized 
in  the  process  of  updating  the  databases. 
All  of  the  update  procedures  follow  the 
same  basic  steps.  The  first  step  is  to 
convert  the  data  into  an  easily  inter¬ 
preted  ASCII  form.  The  form  that  was 
chosen  was  the  VisiCalc  spreadsheet  for¬ 
mat.  The  reason  this  format  was  chosen  is 
because  tools  exist  to  convert  most  other 
types  of  PC  data  files  into  this  ASCII 
format.  These  files  have  an  extension  of 
.DIF.  A  complete  description  of  this  for¬ 
mat  can  be  found  in  the  procedure  DIF2QDK. 
A  copy  of  this  file  can  be  found  in  appen¬ 
dix  B.  DBASE  3  files  can  be  converted 
using  the  DBASE  command  "COPY  TO  FILENAME 
TYPE  DIF".  Lotus  or  Symphony  files  can  be 
converted  using  the  utility  that  is  part 
of  the  Symphony  package  named  WRKDIF.EXE. 

3.1.2.  Uploading  Data  Files. 

Files  in  the  DIF  format  can  then  be 
uploaded  to  the  Pilot  application  using 
the  Pilot  command  "UPLOAD  TEXT".  The 
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procedure  DIF2QDK  can  then  be  used  to  con¬ 
vert  the  DIF  file  into  a  Pilot  table. 
This  table  contains  all  of  the  original 
rows  and  columns  and  adds  a  column  named 
RECNUM  which  is  an  integer  field  that 
represents  the  row  number  in  the  original 
spreadsheet  or  database.  The  DIF2QDK  pro¬ 
cedure  will  also  convert  values  that  can 
not  be  represented  in  Pilot  databases  to 
the  string  value  "N/A".  This  is  necessary 
because  of  wild  card  conflicts  between 
Pilot  and  the  PC  software  programs  from 
which  the  data  came.  This  program  also 
converts  numeric  fields  from  VisiCalc's 
scientific  notation  format  to  real  numbers 
represented  in  a  string  format.  The  con¬ 
vention  of  naming  these  files  (text  file 
name)_TB  has  been  followed  throughout  the 
application . 

3.1.3.  Integrating  New  Data  With  Old. 

The  last  step  is  to  merge  these  new 
Pilot  tables  with  the  original  database. 
This  is  the  function  of  the  EXT  files  in 
the  TOOLS  catalog.  These  files  are  what 
will  require  change  when  the  data  layout 
of  the  original  source  data  changes. 
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3.2.  Assumptions . 

The  following  procedures  will  assume  that 
the  data  will  be  moved  from  its  various 
sources  to  an  IBM  PC  that  is  connected  to  the 
EIS  server  (A  DEC  Micro  Vax  II) .  The  PC  must 
have  the  directory  structure  in  figure  1.  It 
must  also  have  DBASE  3,  Pilot  and  the  Sym¬ 
phony  utilities  in  it's  path.  This  PC  will 
be  referred  to  as  the  EIS  PC  in  the  following 
sections . 

Figure  1 

C:\ 

/ 

DATA 

/ 

DTIC 

/  \ 

LEDGER  PEOPLE 

/  \ 

(CURRENT  MONTH)  (CURRENT  MONTH) 

/  \ 

WKS  DIF 

3.3.  Updating  the  Personnel  Application 
Database . 

3.3.1.  The  Source  Of  the  Data . 

The  source  of  the  personnel  data  is  a 
DBASE  application  maintained  on  a  PC  in 
DTIC-L.  The  following  steps  are  required 
to  integrate  this  data  into  the  Pilot  per¬ 
sonnel  application.  This  section  will 
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explain  how  to  import  data  for  October  of 
1989.  The  same  procedure  can  be  used  to 
import  data  from  other  periods  by  substi¬ 
tuting  the  proper  month. 

Note:  All  procedures  assume  that  the 
current  data  is  the  most  recent.  Therefore 
updates  must  be  applied  in  chronological 
order . 

3.3.2.  Acquiring  Control  of  the  Data . 

The  data  files  are  kept  under  the  MPWR 
subdirectory  on  Arlene  Rowland's  PC.  The 
files  named  MPOSIT.DBF  MEMPLOY . DBF  and 
MACT I VE . DBF  should  be  moved  to  the  EIS  PC 
from  which  the  update  will  take  place  and 
into  the  current  month  directory  under 
\DATA\DTIC\PEOPLE .  For  example  the  com¬ 
mands  to  move  the  October  data  would  be: 

On  Arlene  Rowland's  PC: 

A:\  COPY  C:\MPWR\MPOSIT.DBF  A:MPOSIT .DBF 
A: \  COPY  C:\MPWR\MEMPLOY.DBF  A : MEMPLOY . DBF 
A: \  COPY  C:\MPWR\MACTIVE.DBF  A: MACTIVE . DBF 

And  then  on  the  EIS  PC: 

A: \  MKDIR  C:\DATA\DTIC\PEOPLE\OCT 

A: \  COPY  A : MPOSIT . DBF  C:\DATA\DTIC\PEOPLE\OCT\MPOSIT 
A: \  COPY  A : MEMPL 0 Y . DBF  C:\DATA\DTIC\PEOPLE\OCT\MEMPLOY 
A: \  COPY  A : MACTIVE . DBF  C:\DATA\DTIC\PEOPLE\OCT\MACTIVE 
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3.3.3.  Converting  Data  to  a  Standard  For¬ 
mat  . 

The  DBASE  files  must  now  be  converted 
into  a  standard  format.  The  standard  for¬ 
mat  chosen  for  this  application  is  the 
format  of  a  Visicalc  spreadsheet.  The 
following  series  of  commands  will  perform 
this  transformation. 


C:\  CD  \DATA \DTIC \PEOPLE \ OCT 

C : \DATA\DTIC\PEOPLE\OCT\  DBASE 

DBASE>  USE  MACTIV52 

DBASE>  COPY  TO  ACTIVE  TYPE  DIF 

DBASE>  USE  MEMPLOY 

DBASE>  COPY  TO  EMPLOY  TYPE  DIF 

DBASE>  USE  MPOSIT 

DBASE>  COPY  TO  POSIT  TYPE  DIF 

DBASE>  QUIT 

C:\DATA\DTIC\PEOPLE\OCT\  RENAME  *.DIF  *. TXT 


3.3.4.  Uploading  the  Data . 

Now  the  text  files  are  ready  to  be 
uploaded  to  the  EIS  Server.  They  will  be 
placed  in  a  temporary  catalog  named  TEMP 
to  keep  them  isolated  from  the  application 
until  they  are  in  the  proper  format. 


C:\DATA\DTIC\PEOPLE\OCT\  Pilot 

(log  into  the  EIS  Server  and  start  Pilot) 

?  SET  USER  TEMP 
?  UPLOAD  TEXT  ACTIVE 
?  UPLOAD  TEXT  POSIT 
?  UPLOAD  TEXT  EMPLOY 
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3.3.5.  Converting  to  Pilot's  Format. 


The  following  set  of  commands  will 
convert  these  text  files  into  Pilot 
tables . 


?  SET  USER  TEMP 
?  PATH  TOOLS 

?  CALL  DIF2QDK  (" ACTIVE" ,  ”ACTIVE_TB") 
?  CALL  DIF2QDK  ("POSIT",  "POSIT_TB") 

?  CALL  DIF2QDK  ("EMPLOY",  "EMPLOY  TB") 


3.3.6.  Merging  the  Data  With  the  Applica¬ 
tion  . 

The  tables  are  now  ready  to  be  merged 
with  the  applications  tables.  To  prevent 
problems  with  active  users,  the  production 
tables  are  moved  into  the  TEMP  catalog, 
the  tables  merged  and  then  moved  back  over 
writing  the  original.  The  extract  pro¬ 
cedures  will  display  status  information 
and  indicate  if  there  were  any  errors  in 
the  input  data. 


?  SET  USER  TEMP 
?  PATH  TOOLS 

?  COPY  DTIC2. PERSON  PERSON 
?  COPY  DTIC2. POSITION  POSITION 
?  COPY  DTIC2.SF52  SF52 

?  CALL  EXTRACTPEOPLE  (  "EMPLOY_TB" ,  "PERSON”) 

?  CALL  EXTRACTPOSITION  ("POSIT_TB” ,  "POSITION") 
?  CALL  EXTRACT SF 52  ("ACTIVE  TB",  "SF52") 
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3.3.7.  Executing  the  Cost  Model . 

The  personnel  data  has  now  been 
integrated  with  the  existing  data.  The 
following  steps  are  necessary  to  run  the 
cost  estimation  model  against  the  new 
data.  The  SF52_FIXES  file  changes  the 
format  of  the  dates  in  the  import  data  and 
the  COMP*  procedures  compute  the  actual 
costs.  The  COMP*  procedures  may  indicate 
missing  data  in  the  pay  table.  If  the 
information  exists,  it  should  be  input 
into  the  pay  table  and  then  the  compute 
procedures  run  again. 

?  SET  USER  TEMP 
?  PATH  TOOLS,  DTIC2 
?  CALL  SF52_FIXES 
?  CALL  C0MP_SF52_C0ST  (10,  89) 

?  CALL  COMP_POSITION_COST  (10,  89) 

?  CALL  COMP_PERSON_COST  (10,  89) 

?  CALL  MOVE_COSTS 

3.3.8.  Installing  the  New  Tables. 

The  final  step  is  to  verify  the  tables 
and  then  move  them  into  the  production 
area.  If  the  verify  table  displays  any 
errors,  read  the  relevant  sections  of  the 
Pilot  manuals  and  then  start  over  from 
step  4 . 
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?  SET  USER  TEMP 
?  VERIFY  TABLE  PERSON 
?  VERIFY  TABLE  POSITION 
?  VERIFY  TABLE  SF52 

?  COPY  OVERWRITE  TEMP .PERSON  DTIC2. PERSON 
?  COPY  OVERWRITE  TEMP . POSITION  DTIC2 . POSTION 
?  COPY  OVERWRITE  TEMP.SF52  DTIC2.SF52 


This  completes  the  updating  of  the 
personnel  application.  To  update  the  pay 
table,  pick  that  option  from  the  utility 
popup  menu  on  the  retrace  screen. 


3.4.  Updating  the  financial  database. 

3.4.1.  General  Precautions . 

There  are  several  known  bugs  in  Pilot 
version  3c.  The  most  significant  of  these 
is  with  aggregated  queries.  Syntactically 
correct  queries  may  corrupt  a  data  table 
if  it  is  in  a  writeable  state.  The  pro¬ 
cedures  above  will  open  up  the  table  for 
write  only  when  necessary.  If  a  verify 
table  command  reports  an  error,  then  the 
current  table  is  corrupt  and  must  be 
erased  and  restored  from  a  backup  or 
recreated.  Another  bug  in  the  Pilot  data¬ 
base  may  prevent  transactions  with 
descriptions  that  are  longer  than  20  char¬ 
acters  from  being  correctly  retrieved  when 


78 


queried  by  the  description  field.  This 
problem  only  affects  character  fields. 
This  is  more  of  an  issue  with  the  SMDR 
database  but  it  could  arise  in  this  appli¬ 
cation. 

There  was  some  discussion  about  refor¬ 
matting  the  ledger  spreadsheets  for  fiscal 
year  1990.  If  the  ledgers  were  reformat¬ 
ted  then  a  new  set  of  extract  procedures 
will  need  to  be  created. 

3.4.2.  Source  of  the  Data . 

The  source  of  the  financial  data  is  a 
set  of  Lotus  spreadsheets  maintained  by 
Ms.  Debbie  Fersch.  Ms.  Fersch  has  been 
providing  monthly  copies  of  these 
spreadsheets  for  the  EIS  applications. 
This  data  should  then  be  copied  to  the 
\DATA\DTIC\LEDGER\OCT\WKS  directory.  The 
following  commands  will  move  the  data. 
(The  source  data  is  on  two  360K  floppy 
disks) 


(Insert  first  floppy  disk  in  the  A  drive) 

A: \  MKDIR  C:\DATA\DTIC\LEDGER\OCT 

A: \  COPY  A:*.*  C:\DATA\DTIC\LEDGER\OCT 

(Remove  the  first  floppy  and  insert 
the  second  floppy  in  A  drive . ) 

A: \  COPY  A:*,*  C:\DATA\DTIC\LEDGER\OCT 
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3.4.3.  Convert  Data  to  a  Standard  Format . 

Next,  the  Lotus  spreadsheets  should  be 
translated  into  VisiCalc  worksheets.  This 
is  performed  by  a  Lotus  translation  util¬ 
ity  named  WRKDIF.EXE  or  by  an  option  under 
the  translate  utility  depending  on  the 
version  of  Lotus.  The  following  batch 
command  procedure  will  convert  all  of  the 
files  using  the  WRKDIF.EXE  program.  This 
procedure  can  be  found  in  the  \DATA\DTIC\ 
directory  on  the  EIS  PC.  The  file  named 
CONVERT . BAT  contains  the  following  com¬ 
mands  . 


CD  WKS 
MKDIR  TEMP 

FOR  %%F  IN  ( * . WKS )  DO  WRKDIF  %%F  TEMP\%%F 
CD  .  . 

COPY  WKS\TEMP\* .WKS  DIF\*.TXT 
CD  WKS\TEMP 
DELETE  * . WKS 
CD  .  . 

RMDIR  TEMP 
CD  .  . 

DIR  DIF\  >DIF\NAMES . DAT 


This  command  procedure  can  be  called  in 
the  following  manner. 

C:\  CD  \DATA \DT I C\ LEDGER \ OCT 

C:\DATA\DTIC\LEDGER\OCT  . . \ . . \CONVERT.BAT 


After  running  this  procedure,  the 
*.DIF  files  should  be  verified.  If  the 
file  size  of  any  of  the  *.DIF  files  is  0, 
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this  may  indicate  that  the  hard  disk  drive 
is  full.  Some  types  of  errors  are  logged 
in  the  TRANS.  $$$  file  in  the  \DIF  direc¬ 
tory  so  this  file  should  also  be  checked. 

3.4.4.  Upload  Data . 

The  next  step  is  to  upload  the  data 
files  to  the  EIS  Server.  The  file  named 
"UPLOAD_TEXT"  in  the  TOOLS  catalog  will 
perform  this  step. 

C:\  CD  \DATA \DTIC\ LEDGER \ OCT 

C : \DATA\DTIC\LEDGER\OCT  Pilot 

(log  into  the  EIS  Server  and  start  Pilot) 

?  SET  USER  TEMP 
?  PATH  TOOLS 

?  CALL  UPLOAD_  TRANSACTI ON 

3.4.5.  Convert  to  Pilot  Format . 

Then  the  text  files  in  VisiCalc  format 
must  be  converted  into  Pilot  database 
tables.  The  following  commands  will  per¬ 
form  this  task. 

?  SET  USER  TEMP 
?  PATH  TOOLS 

?  CALL  CONVERT_  T0_  TABLES 

3.4.6.  Combine  into  One  Table . 

Consolidating  these  tables  into  a  sin¬ 
gle  table  is  performed  by  the 
"EXTRACT_LEDGER"  procedure.  This 
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procedure  assumes  the  existence  of  an 
empty  table  named  C&0_TRANSACTI0N.  This 
table  may  be  created  and  filled  in  the 
following  manner. 

?  SET  USER  TEMP 

?  PATH  TOOLS,  DTIC2 

?  CALL  MY_MAKETABLE  ("C& 0_TRANS. ACTION") 

?  CALL  EX  TRA  C  T_  LED  GER 

?  UPDATE  TABLE  C& 0_ TRANSACTION  READONLY 

3.4.7.  Verify  Data. 

At  this  point  the  ledger  data  must  be 
verified!  First  the  error  log  that 
EXTRACT_LEDGER  creates  must  be  reviewed 
and  then  object  class  totals  should  be 
double  checked  against  the  original  Lotus 
spreadsheet  total  lines.  There  are  four 
different  types  of  errors  that  could  be 
present  at  this  point.  If  the  OC_CHECK 
procedure  shows  any  discrepancies  then 
take  the  necessary  error  correction  steps. 
OC_CHECK  may  be  run  in  the  following 
manner . 

?  SELECT  TEMP . C&  0_  TRANSACTION : 

?  CALL  TOOLS.  OC_CHECK 

3.4.8.  Error  Correction  Steps . 
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3. 4. 8.1.  Incorrect  Object  Class. 

Some  transactions  represent  more 
than  one  office  or  object  class.  At 
present,  this  information  is  not 
represented  in  a  machine  interpretable 
fashion  so  these  errors  can  not  be 
detected  or  corrected. 

3. 4. 8. 2.  New  Office  Symbols. 

New  and  wonderful  office  symbols 
may  have  been  used  in  one  or  more  of 
the  transaction  files.  This  is  the 
most  frequent  type  of  problem.  These 
problems  may  be  corrected  by  adding 
the  new  office  symbol  to  the 
TOOLS . SYNONYMS :  table.  This  table  con¬ 
tains  a  list  of  all  the  valid  office 
names  in  the  term  column  and  all  the 
aliases  that  have  been  recorded  so  far 
in  the  alias  column.  The  extract  pro¬ 
cedures  lookup  valid  names  in  this 
table.  They  flag  names  not  found  in 
this  file  as  invalid.  After  adding  the 
new  symbols  to  this  table,  the 
C&0__TRANSACTI0N  file  in  the  TEMP  cata¬ 
log  must  be  deleted  and  recreated. 
This  is  necessary  because  the  extract 
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procedures  have  to  place  exactly  one 
entry  in  the  C&0_TRANSACTI0N  table  for 
each  record  in  the  source  files 
including  those  with  new  office  sym¬ 
bols  for  the  totals  to  be  accurate. 
The  following  commands  will  add  the 
alias  "DTIC_LRE"  to  the  database  as 
another  name  for  "LRE"  and  then  erase 
the  transaction  table.  After  perform¬ 
ing  this  step,  all  steps  following  the 
step  to  convert  the  source  data  into 
Pilots  format  must  be  performed  again. 

?  SELECT  TOOLS. SYNONYM: 

?  MAKE  RECORD  FIELD  ALIAS  - 

-?  "DTIC_LRE :  "  FIELD  TERM  "LRE" 

?  UPDATE  TABLE  TEMP  ,C&0_ TRANSACTION 

-?  NOREADONLY 

?  ERASE  TABLE  TEMP .  C&0_TRANS  ACT  ION : 

3. 4. 8. 3.  Invalid  Characters  in  Input. 

Special  characters  could  have  been 
used  for  office  names.  If  a  special 
character  is  used  in  a  text  field  in 
the  original  spreadsheets  that  Pilot 
can  not  represent  in  its  database  and 
that  character  is  not  already  treated 
specially  in  DIF2QDK,  the  record  may 
not  have  been  created  in  the  *_TB 
table.  The  only  way  to  correct  for 
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this  type  of  error  is  to  modify 
DIF2QDK. 


3. 4. 8. 4. 

Extraneous 

Subtotals . 

Subtotal  transaction 

records 

may 

have  been  imported. 

The 

travel 

and 

training 

expenses 

are 

recorded 

in 

separate 

worksheets 

from 

the  rest 

of 

their  object  class.  If  the  physical 
location  of  the  total  records  is  moved 
in  these  spreadsheets,  it  will  get 
imported.  If  this  happens  the  subto¬ 
tal  record  must  be  deleted  and  the 
extract  procedure  that  imported  the 
record  updated  to  reflect  the  new 
location  of  this  record.  This  can  be 
done  by  modifying  the  RECNUM  constant 
in  the  extract  procedure  and  recompil¬ 
ing. 

3.4.9.  Manual  Data  Cleanup . 

Several  additional  checks  must  be  per¬ 
formed  before  the  summary  procedure  can  be 
run.  This  involves  making  sure  that  all 
of  the  records  have  valid  project  codes. 
If  any  of  the  transactions  have  project 
codes  of  ""  then  the  summary  procedure 


85 


will  fail 


This  situation 


can  be 


corrected  with  the  following  set  of  com¬ 
mands 

?  UPDATE  TABLE  C&0_TRANSACTI0N  NOREADONLY 
?  SELECT  TEMP . C&0_  TRANSACTI ON : 

?  UPDATE  RECORD  PROJECT_CODE  <  " 

-?  0"  FIELD  PROJECT_CODE  " NA " 

?  UPDATE  TABLE  C&0_TRANSACTI0N  READONLY 

3.4.10.  Compute  Summary  Records . 

At  this  point  the  transaction  data  is 
ready  to  be  summarized  into  the  summary 
table.  The  following  set  of  commands  will 
append  the  new  information  to  the  existing 
summary  information. 


?  SET  USER  TEMP 
?  PATH  TOOLS,  DTIC2 

?  COPY  DTIC2  .  C&0_SUMMARY  TEMP .  C&0_SUMMARY 
?  UPDATE  TABLE  C&0_TRANSACTI0N  NOREADONLY 
?  UPDATE  TABLE  C&0_SUMMARY  NOREADONLY 
?  CALL  UP  DA  TE_  S  UMMAR  Y  (  "C&0_  TRANSACTION",  - 
-?  "C&0_SUMMARY" ,  10,  89) 

?  UPDATE  TABLE  C&0_TRANSACTI0N  READONLY 

?  UPDATE  TABLE  C&0_SUMMARY  READONLY 

?  SELECT  TEMP . C&0_SUMMARY : 

?  CALL  0C_CHECK 
?  VERIFY  TABLE 


3.4.11.  Installation  of  New  Tables. 

If  the  object  class  check  is  correct 
then  the  tables  can  be  moved  into  the  pro¬ 
duction  area.  It  is  strongly  recommended 
that  the  system  be  backed  up  to  tape 
before  the  new  data  is  installed!  There 
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should  not  be  anybody  using  the  applica¬ 
tion  when  the  following  step  is  performed. 

?  COPY  OVERWRITE  TEMP  .  C&0_TRANSACT ION  DTIC2  . 
?  COPY  OVERWRITE  TEMP .  C&0_SUMMARY  DTIC2 . 

3.4.12.  Allowing  Users  to  See  Updates. 

The  last  step  is  to  update  the  pro¬ 
cedure  GO  so  that  the  users  will  see  the 
new  data  by  default  when  they  log  in. 
This  is  done  by  editing  the  procedure  GO 
and  replacing  the  values  of  CMONTH  and 
CYEAR  with  the  month  and  year  of  the  data 
just  loaded. 

3.5.  Updating  the  SMDR  Database . 

The  SMDR  database  can  be  updated  and 
corrected  using  the  menu  interface's  edit  facil¬ 
ity  in  the  SMDR  application. 

3.6.  Updating  the  Authorization  Database. 

There  is  currently  no  method  of  updating  the 
authorization  database  other  than  through  the 
menu  interface. 
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3.7.  Updating  the  Pay  tables . 

The  only  method  currently  available  uses 
Enterview.  This  is  sufficient  for  making  small 
modifications  but  inconvenient  for  major  updates. 

3.8.  Updating  the  Privilege  Table. 

Updating  the  privilege  table  is  currently 
performed  from  the  Pilot  command  line. 

3.9.  Updating  the  Object  Class  Detail  Table. 

Updating  of  the  object  table  is  currently 
performed  from  the  command  line. 

3.10.  Updating  the  Organization  Table. 

The  organization  table  can  be  updated  from 
the  application  using  the  "edit"  feature  or  the 
Pilot  command  line.  Some  operations  can  only  be 
performed  from  the  Pilot  command  line.  These 
operations  include  adding  or  removing  an  organi¬ 
zation  from  the  structure. 

3.11.  Updating  the  Salary  Flag  Table. 

The  salary  flag  table  can  only  be  updated 
from  the  Pilot  command  line. 
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APPENDIX  A 


The  Files  in  the  Prototype. 


A- 1 


Following  is  a  list  of  all  of  the  files  in  this  applica¬ 
tion  and  a  short  explanation  of  when  they  are  called  and 
what  they  do.  It  begins  by  listing  the  procedures  executed 
when  the  application  is  run.  Next  is  the  list  of  menus 
displayed  during  application  execution.  Following  is  a 
list  of  procedures  and  text  files  that  are  used  for  updat¬ 
ing  and  maintenance. 


Procedures  in  the  DTIC2  Catalog. 

File  Name  Function 

BUDGET 1_FIX_DBR  This  procedure  is  called  from  BUDGET1.  It 

cleans  up  a  database  reference  before  pass¬ 
ing  it  to  BUDGET2 . 

BUDGET2_FIX_DBR  This  procedure  is  called  from  BUDGET2 .  It 

cleans  up  a  database  reference  before  pass¬ 
ing  it  to  BUDGET3. 

DAINSTL  This  procedure  installs  Enterview  in  a  user 

catalog.  It  is  part  of  the  Enterview  suite 
of  code  but  is  not  called  in  this  applica¬ 
tion. 

DAPROCS  This  procedure  contains  most  of  Enterview' s 

supporting  code. 

DATSPRO  This  procedure  contains  the  rest  of 

Enterview' s  code. 

EDITBUDGET2  This  procedure  is  called  when  a  button  is 

selected  when  in  edit  mode  on  BUDGET2 .  It 
performs  the  actual  database  updates. 

EDITENNABLEBUDGET2  This  procedure  is  called  when  the  edit  but¬ 
ton  on  BUDGET2  is  called.  It  changes  the 
text  of  the  edit  button  and  enables  cells 
that  can  be  edited  and  disables  those  that 
can  not. 

EDITENABLE0RGAN1  This  procedure  is  called  when  the  edit  but¬ 

ton  on  ORGANIZATION!  is  called.  It  changes 
the  text  of  the  edit  button  and  enables 
cells  that  can  be  edited  and  disables  those 
that  can  not. 

EDITENABLEPERS0N1  This  procedure  is  called  when  the  edit  but¬ 
ton  on  PERS0N1  is  called.  It  changes  the 
text  of  the  edit  button  and  enables  cells 
that  can  be  edited  and  disables  those  that 
can  not . 
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File  Marne 


Procedures  in  the  DTIC2  Catalog 

Function 


EDITENABLEPERS0N2 


ED I TENAB LEP OS I T I ON 1 


EDITENABLEP0SITI0N2 


ED I TENABLE SMDR1 


ED IT ORGAN 1 


EDITPERS0N1 


EDITPERS0N2 


EDITPOSITION1 


EDITP0SITI0N2 


EDITSMDR1 


FILLBUDGET1 


This  procedure  is  called  when  the  edit  but¬ 
ton  on  PERS0N2  is  called.  It  changes  the 
text  of  the  edit  button  and  enables  cells 
that  can  be  edited  and  disables  those  that 
can  not . 

This  procedure  is  called  when  the  edit  but¬ 
ton  on  P0SITI0N1  is  called.  It  changes  the 
text  of  the  edit  button  and  enables  cells 
that  can  be  edited  and  disables  those  that 
can  not . 

This  procedure  is  called  when  the  edit  but¬ 
ton  on  P0SITI0N2  is  called.  It  changes  the 
text  of  the  edit  button  and  enables  cells 
that  can  be  edited  and  disables  those  that 
can  not. 

This  procedure  is  called  when  the  edit  but¬ 
ton  on  SMDR1  is  called.  It  changes  the  text 
of  the  edit  button  and  enables  cells  that 
can  be  edited  and  disables  those  that  can 
not . 

This  procedure  is  called  when  a  button  is 

selected  wher  in  edit  mode  on  ORGAN  I Z  AT  I  ON  1 . 
It  performs  tne  actual  database  updates. 

This  procedure  is  called  when  a  button  is 

selected  when  in  edit  mode  on  PERS0N1.  It 
performs  the  actual  database  updates. 

This  procedure  is  called  when  a  button  is 

selected  when  in  edit  mode  on  PERS0N2 .  It 
performs  the  actual  database  updates. 

This  procedure  is  called  when  a  button  is 

selected  when  in  edit  mode  on  P0SITI0N1.  It 
performs  the  actual  database  updates. 

This  procedure  is  called  when  a  button  is 

selected  when  in  edit  mode  on  POSITION2.  It 
performs  the  actual  database  updates. 

This  procedure  is  called  when  a  button  is 

selected  when  in  edit  mode  on  SMDR1 .  It 
performs  the  actual  database  updates. 

This  procedure  fetches  data  from  the  data¬ 
base  and  loads  it  into  the  cells  of  BUDGET1. 


A- 3 


Pile  Hama 

FILLBUDGET2 

FILLBUDGET3 

FILLC0ST1 

FILLLEDGER1 

FILLLEDGER2 

FILLLEDGER3 

FILLLEDGER4 

FILLORGAN1 

FILLPERS0N1 

FILLPERSON2 

FILLPOPLIST 

FILLPOSITION1 

FILLPOSITION2 

FILLSELECTION1 


Procedures  in  the  DTIC2  Catalog. 

Function 

This  procedure  fetches  data  from  the  data¬ 
base  and  loads  it  into  the  cells  of  BUDGET2 . 

This  procedure  fetches  data  from  the  data¬ 
base  and  loads  it  into  the  cells  of  BUDGET3 . 

This  procedure  fetches  data  from  the  data¬ 

base  and  loads  it  into  the  cells  of  C0ST1. 

This  procedure  fetches  data  from  the  data¬ 

base  and  loads  it  into  the  cells  of  LEDGER1 . 

This  procedure  fetches  data  from  the  data¬ 

base  and  loads  it  into  the  cells  of  LEDGER2 . 

This  procedure  fetches  data  from  the  data¬ 

base  and  loads  it  into  the  cells  of  LEDGER3 . 

This  procedure  fetches  data  from  the  data¬ 

base  and  loads  it  into  the  cells  of  LEDGER4 . 

This  procedure  fetches  data  from  the  data¬ 

base  and  loads  it  into  the  cells  of  ORGAN I - 
ZATIONl . 

This  procedure  fetches  data  from  the  data¬ 

base  and  loads  it  into  the  cells  of  PERS0N1. 

This  procedure  fetches  data  from  the  data¬ 

base  and  loads  it  into  the  cells  of  PERS0N2 . 

This  procedure  fetches  data  from  the  data¬ 

base  and  loads  it  into  the  cells  of  POPLIST. 

This  procedure  fetches  data  from  the  data¬ 
base  and  loads  it  into  the  cells  of  POSI- 

TI0N1 . 

This  procedure  fetches  data  from  the  data¬ 
base  and  loads  it  into  the  cells  of  POSI¬ 

TION  . 

This  procedure  fetches  data  from  the  data¬ 

base  and  loads  it  into  the  cells  of  SELEC¬ 
TION!  . 
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File  Name 


Procedures  in  the  DTIC2  Catalog. 

Function 


FILLSELECTI0N2 

FILLSELECTI0N3 

FILLSELECTI0N4 

FILLSELECTI0N5 

FILLSMDR1 

FILLSMDR2 

F I L LWORK  S HEE T_P OP 1 

GO 

GRAPH1C0ST1 

GRAPH 1LEDGER3 

GRAPH1SMDR1 

LEDGER3  BUILD  DBR 


This 

procedure 

fetches 

data 

from 

the 

data- 

base 

TI0N2 

and  loads 

it  into 

the 

cells 

of 

SELEC- 

This 

procedure 

fetches 

data 

from 

the 

data- 

base 

TI0N3 

and  loads 

it  into 

the 

cells 

of 

SELEC- 

This 

procedure 

fetches 

data 

from 

the 

data- 

base 

TION4 

and  loads 

it  into 

the 

cells 

of 

SELEC- 

This 

procedure 

fetches 

data 

from 

the 

data- 

base 

TI0N5 

and  loads 

it  into 

the 

cells 

of 

SELEC- 

This 

procedure 

fetches 

data 

from 

the 

data- 

base 

and  loads 

it  into  the  cells  of 

SMDR1 . 

This 

procedure 

fetches 

data 

from 

the 

data- 

base 

and  loads 

it  into  the  cells  of 

SMDR2 . 

This 

procedure 

fetches 

data 

from 

the 

data- 

base 

and  loads  it 

into 

the 

cells  of 

WORKSHEET_POPl. 

This  is  the  procedure  that  starts  the  appli¬ 
cation.  It  is  called  directly  by  a  user  or 
from  their  startup  procedure.  It  estab¬ 
lishes  the  default  date,  determines  a  users 
privileges,  calls  RINIT  and  calls  the  top 
menu . 

This  procedure  graphs  the  data  shown  on  the 
COST1  screen.  It  is  called  by  the  graph 
buttons  on  that  screen. 

This  procedure  graphs  the  data  shown  on  the 
LEDGER3  screen.  It  is  called  by  the  graph 
buttons  on  that  screen. 

This  procedure  graphs  the  data  shown  on  the 
SMDR1  screen.  It  is  called  by  the  graph 
buttons  on  that  screen. 

This  procedure  is  called  by  the  link  buttons 
on  LEDGER3  to  clean  up  the  database  refer¬ 
ence  before  running  LEDGER4 . 
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V 


File  Name 


Procedures  in  the  DTIC2  Catalog. 

Function 


LEDGER__AGGR_OFFICE 

MAKE SELECT I0N1 

MAKE SELECT I0N2 

MAKE SELECT I 0N3 

MAKE SELECT I0N4 

MAKESELECTI0N5 

MYTRACE 

PRINTFILE 

RTINIT 

SELECT I ONI FIXDBR 

SELECT I0N4FIXDBR 

SELECTI0N4  MAKE  TTL 


This  procedure  is  called  by  FILLLEDGER1  and 
FILLLEDGER3  to  aggregate  data  based  on 
offices . 

This  procedure  builds  a  database  reference 
as  the  user  selects  items  from  the  associ¬ 
ated  selection  screen. 

This  procedure  builds  a  database  reference 
as  the  user  selects  items  from  the  associ¬ 
ated  selection  screen. 

This  procedure  builds  a  database  reference 
as  the  user  selects  items  from  the  associ¬ 
ated  selection  screen. 

This  procedure  builds  a  database  reference 
as  the  user  selects  items  from  the  associ¬ 
ated  selection  screen. 

This  procedure  builds  a  database  reference 
as  the  user  selects  items  from  the  associ¬ 
ated  selection  screen. 

This  is  a  very  slightly  modified  version  of 
Pilot's  retrace  procedure.  This  procedure 
is  called  by  almost  every  menu  to  add  a 
screen  to  the  retrace  stack. 

This  procedure  loads  a  text  file  into  an 
array  for  display  in  COMMENT : FOOTNOTE . 

This  procedure  will  initialize  the  retrace 
stack,  it  is  called  from  go. 

This  procedure  modifies  the  office  clause  in 
a  data  base  reference  to  include  subordi¬ 
nates.  It  is  called  when  the  include  subor¬ 
dinates  button  is  selected. 

This  procedure  modifies  the  office  clause  in 
a  data  base  reference  to  include  subordi¬ 
nates.  It  is  called  when  the  include  subor¬ 
dinates  button  is  selected. 

This  procedure  creates  a  title  for  the  next 
screen.  It  is  called  by  some  of  the  link 
buttons  on  SELECTI0N4. 
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Procedures  in  the  DTIC2  Catalog . 


File  Name 

Function 

SELECTION_LIST 

This  procedure  is  called  by  all  of  the  MAK- 
ESELECTION  procedures.  It  packages  the 
calls  to  and  parses  the  results  from  calls 
to  popup  lists. 

SELECTION_TYPE 

This  procedure  is  called  by  all  of  the  MAK- 
ESELECTION  procedures.  It  interprets  the 
data  a  user  types  in  response  to  a  "Type" 
cell  on  a  selection  screen.  It  will  call 

selection_list  as  a  response  to  ambiguous 
input  . 

SMDR_CALC_COL 

This  procedure  will  calculate  column  totals 
when  a  monthly  value  is  changed  while  edit¬ 
ing  data  on  the  SMDR1  screen. 

UPONE 

This  procedure  is  called  by  the  "UPONE"  but¬ 
tons  on  almost  every  screen.  It  pops  the 

name  of  the  cached  menu  that  is  at  the  top 
of  the  retrace  stack. 

W0RKSHEET_SMDR1 

This  procedure  retrieves  the  necessary  con¬ 
trol  information  and  then  calls  the  menu 
W0RKSHEET_P0P1 . 

WSCALC 

This  procedure  is  part  of  Pilot's  worksheet 
application. 

WSFILL 

This  procedure  is  part  of  Pilot's  worksheet 
application . 

WSGRAPH 

This  procedure  is  part  of  Pilot's  worksheet 
application . 

WSINSTL 

This  procedure  is  part  of  Pilot's  worksheet 
application . 

WSPROCS 

This  procedure  is  part  of  Pilot' s  worksheet 
application . 

WSSRPOP 

This  procedure  is  part  of  Pilot's  worksheet 
application . 

WS START 

This  procedure  is  part  of  Pilot's  worksheet 
application . 
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Menu  Name 


BUDGET 1 
BUDGET2 

BUDGET3 

C0ST1 

LEDGER1 

LEDGER2 

LEDGER3 

LEDGER4 
ORGAN I ZAT I ONI 
PERSON1 
PERSON2 
POPLIST 

POPLIST2 

POSITION1 

POSITION2 

SELECTION1 

SELECTION2 


Menus  in  the  DT1C2  Catalog. 

In  file  DTIC2 .MENUFILE : 

Function 

This  menu  is  a  listing  of  authorizations. 

This  menu  displays  details  about  a  specific 
authorization . 

This  menu  displays  the  history  of  an  author¬ 
ization. 

This  menu  displays  cost  details  from  the 
personnel  application. 

This  menu  presents  summaries  of  office  vs 
object  class  vs  project  code. 

This  menu  presents  listings  of  transactions. 

This  menu  displays  checkbook  summaries 
aggregated  across  one  dimension. 

This  menu  displays  transaction  details. 

This  menu  displays  an  organization  chart. 

This  menu  presents  a  list  of  several  people. 

This  menu  presents  details  on  one  person. 

This  menu  presents  a  list  of  options  an 
allows  the  user  to  select  one  option. 

This  menu  presents  a  two  column  list  and 
allows  the  user  to  select  one  option  from 
the  left  column. 

This  menu  presents  a  list  of  several  posi¬ 
tions  . 

This  menu  displays  details  on  1  position  and 
the  occupants  names. 

This  menu  allows  the  user  to  select  a  group 
of  people  to  list. 

This  menu  allows  the  user  to  select  a  group 
of  positions  to  list 


SELECTI0N3 


This  menu  allows  the  user  to  select  a  group 
of  transactions  to  list. 


Menus  in  the  DTIC2  Catalog. 

In  file  DTIC2 .MENUFILE : 

Menu  Name  Function 

SELECTI0N4  This  menu  allows  the  user  to  select  groups 

of  offices,  object  classes,  project  codes 
and  program  codes  and  display  summaries  or 
transactions . 

SELECTIONS  This  menu  allows  the  user  to  select  authori¬ 

zations  to  list. 

SMDRl  This  menu  displays  the  SMDR  details. 

SMDR2  This  menu  allows  the  user  to  select  the  SMDR 

table  to  show  details  about. 

TOP  This  is  the  DTIC  prototype  entry  screen. 

UTILl  This  menu  allows  the  user  to  edit  the  pay 

table,  change  passwords  or  flush  cached 
menus  after  editing  data. 

W0RKSHEET_P0P1  This  menu  allows  the  user  to  select  what 

data  they  would  like  to  copy  from  LEDGERl 
into  the  worksheet. 


Menu  Name 

FOOTNOTE 

INPUT 


Menus  in  the  DTIC2  Catalog. 

In  file  DTIC2 . COMMENT : 

Function 

This  menu  displays  the  SMDR  footnotes. 

This  menu  allows  the  user  to  enter  design 
comments . 


Menus  in  the  DTIC2  Catalog. 

In  file  DTIC2.RT: 

Menu  Name  Function 


RETRACE 


This  menu  allows  the  user  to  pick  any  menu 
in  the  retrace  list  and  jump  directly  to  it. 


A- 9 


All  menus 
Menu  Name 

Menus  in  the  DTIC2  Catalog. 

In  file  DTIC2.DA: 

in  this  file  are  part  of  the  Pilot  Enterview  application 

Function 

STRMEN 

Data  Entry 

String  Menu 

TABLE 

Data  Entry 

Main  Menu 

TSMEN 

Data  Entry 

Timeseries  Menu 

TSPER 

Period  Pop- 

■up  called  from  TSMEN 

Menus  in  the  DTIC2 

Catalog . 

In  File  DTIC2 . DAHELPM : 

All  menus 

in  this 

file 

are  part  of 

the 

Pilot  Enterview  application 

HBOTTOM 

HCLEAR 

HD  OWN 

HERASE 

HEXIT 

HFIELD 

HMAKE 

HNEXTRECO 

HSELECT 

HTABLE 

HTOP 

HTSBOTTOM 

HTSDATA 

HTSDELETE 

HTSDOWN 

HTSEXIT 

HTSFIRST 

HTSLABEL 

HTSLAST 

HTSPERIOD 

HTSSTORE 

HTSTITLE 

HTSTOP 

HTSTYPE 

HTSUP 

HTSVAR 

HUP 

HUP DATE 

HVALUE 

HVALUE 2 

Menus  in  the  DTIC2 

Catalog . 

In  file  DTIC2 

.WS: 

All  menus 

in  this 

file 

are  part  of 

the 

Pilot  Worksheet 

application 

Menu  Names 

Function 

WORKSHEET 

Worksheet 

Menu 

Menus  in  the  DTIC2 

Catalog . 

In  file  DTIC2 . 

WSH : 

All  menus 

in  this 

file 

are  part  of 

the 

Pilot  Worksheet 

application 

Menu  Name 

Function 

CALCCONSTANTHELP  Calc  Constant  Help  Pop-up 
CALCCUMHELP  Calc  Cum  Function  Help  Pop-up 

CALCOPERSHELP  Calc  Math  Operators  Help 

CALCTRENDHELP  Trend  Function  Help  Pop-up 

CLEARHELP  Clear  Button  Help  Pop-up 

DATESHELP  Dates  Button  Help  Pop-up 

DELETEHELP  Delete  Button  Help  Pop-Up 
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All  menus  in  this 
Menu  Name 

DOWNLOADHELP 

GOTOPCHELP 

GRAPHHELP 

LEADLAGHELP 

MOVAVGHELP 

RENAMEHELP 

RETURNHELP 

REVERSEHELP 

WSCELLSHELP 

CALC_GM_PAY 

COMPUTE_NIGHT_DIF 

COMP_P  ERS  ON_C  0  S  T 
COMP_P  0  S I T I ON_C 0  S  T 
COMP_SF52_COST 
CONVERT_TO_TABLES 
DESIGN_COMMENT_TBL 

DIF2QDK 


Menus  in  the  DTIC2  Catalog. 

In  file  DTIC2.WSH: 

file  are  part  of  the  Pilot  Worksheet  application. 

Function 

Download  Button  Help  Pop-up 
Go  to  PC  Button  Help  Pop-up 
Graph  Button  Help  Pop-up 
Calc  Lead/Lag  Function  Help 
Moving  Average  Function  Help 
Rename  Button  Help  Pop-Up 
Return  Button  Help  Pop-up 
Reverse  Button  Help  Pop-up 
Worksheet  Items  Help  Pop-up 


Files  in  the  Tools  Catalog. 

File  name 

This  procedure  copies  all  of  the  "GS" 
records  in  the  pay  table  and  changes  their 
service  to  "GM" . 

This  procedure  creates  the  night  differen¬ 
tial  records  at  a  percentage  rate  of  the 
normal  scale. 

This  procedure  will  compute  the  incumbent 
portion  of  the  personnel  cost  model. 

This  procedure  will  compute  the  first  esti¬ 
mate  portion  of  the  cost  model. 

This  procedure  will  compute  the  impact  of  SF 
52' s  on  the  cost  model. 

This  procedure  will  take  the  ledger  text 
files  and  convert  them  to  tables. 

This  procedure  will  output  the  contents  of 
the  design  comments  table  with  embedded  UNIX 
tbl  commands  for  printing. 

This  procedure  will  convert  a  VisiCalc 
spread  sheet  into  a  Pilot  table. 
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Files  in  the  Tools  Catalog. 

File  name 

EXTL115  This  procedure  will  extract  the  relevant 

records  from  a  table  formatted  like  the  one 
DIF2QDK  produces  when  given  the  Visicalc 

equivalent  of  the  ledger  file  L115.WKS  and 
insert  them  into  the  C&0__Transaction  table. 

EXTL1263  This  procedure  will  extract  the  relevant 

records  from  a  table  formatted  like  the  one 
DIF2QDK  produces  when  given  the  Visicalc 

equivalent  of  the  ledger  file  L1263.WKS  and 
insert  them  into  the  C&0_Transaction  table. 

EXTL2216  This  procedure  will  extract  the  relevant 

records  from  a  table  formatted  like  the  one 
DIF2QDK  produces  when  given  the  Visicalc 

equivalent  of  the  ledger  file  L2216.WKS  and 
insert  them  into  the  C&0_Transaction  table. 

EXTL24  This  procedure  will  extract  the  relevant 

records  from  a  table  formatted  like  the  one 
DIF2QDK  produces  when  given  the  Visicalc 

equivalent  of  the  ledger  file  L24.WKS  and 
insert  them  into  the  C&0_Transaction  table. 

EXTPAY  This  procedure  will  extract  records  from  a 

text  file  formatted  like  TOOLS .GSTABLE  and 
insert  them  into  the  pay  table. 

EXTRACT52  This  procedure  will  extract  the  relevant 

records  from  a  table  formatted  like  the  one 
DIF2QDK  produces  when  given  the  VisiCalc 

equivalent  of  MACTIVE . DBF  personnel  file. 

EXTRACTAUTH  This  procedure  will  extract  the  relevant 

records  from  a  table  formatted  like  the  one 
DIF2QDK  produces  when  given  the  VisiCalc 

equivalent  of  Gary  Skipper's  authorization 
spread  sheet. 

EXTRACTLEDGER  This  procedure  will  call  the  EXTL*  pro¬ 

cedures  with  the  proper  parameters  to  con¬ 
vert  a  complete  ledger  as  represented  in 
files  produced  by  DIF2QDK  into  one  table. 

EXTRACTPEOPLE  This  procedure  will  extract  the  relevant 

records  from  a  table  formatted  like  the  one 
DIF2QDK  produces  when  given  the  VisiCalc 

equivalent  of  MEMPLOY.DBF  personnel  file. 
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Files  in  the  Tools  Catalog. 

File  name 

EXTRACTPOSITION  This  procedure  will  extract  the  relevant 

records  from  a  table  formatted  like  the  one 
DIF2QDK  produces  when  given  the  VisiCalc 

equivalent  of  MPOSIT.DBF  personnel  file. 

EXTTRAINING  This  procedure  will  extract  the  relevant 

records  from  a  table  formatted  like  the  one 
DIF2QDK  produces  when  given  the  VisiCalc 

equivalent  of  the  ledger  file  TRAINING. WKS 
and  insert  them  into  the  C&0_Transaction 
table . 

EXTTRAVEL  This  procedure  will  extract  the  relevant 

records  from  a  table  formatted  like  the  one 
DIF2QDK  produces  when  given  the  VisiCalc 

equivalent  of  the  ledger  file  TRAVEL. WKS  and 
insert  them  into  the  C&0_Transaction  table. 

FILL_TRANSACTION_TAB  This  is  another  version  of  EXTRACTLEDGER . 

MAKE_TABLE_OLD  This  is  a  utility  program  which  will  dump  a 

table  into  a  form  that  can  be  edited  by  a 
word  processor  and  then  rebuilt. 

MOVE_COSTS  This  procedure  will  move  the  incumbent  and 

SF52  costs  into  the  position  table  so  they 
can  be  maintained  and  displayed. 

MY_MAKETABLE  This  procedure  will  create  an  empty  table 

for  this  application  depending  on  the  defin¬ 
ition  in  the  table. 

TABLE_DETAIL  This  is  a  table  that  contains  descriptions 

of  all  of  this  applications  tables  and  the 
fields  in  them. 

OC_CHECK  This  procedure  will  produce  a  list  o^  sum¬ 

maries  that  should  coincide  with  the  totals 
at  the  bottom  of  each  Lotus  spread  sheet 
that  compose  the  ledger. 

PERSON_OFFICE_CREATE  This  procedure  was  used  initially  to  fill 

the  office  field  in  the  person  table. 

RECOMPUTE_PAY_WG  This  procedure  was  used  to  recompute  the  WG 

pay  rates  after  they  were  entered 
incorrectly . 
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RECOMPUTE_PAY_WS 

SF52_FIXES 

SMDRCUM 

SMDRLOAD 

SMDRRENAMEFOOTNOTE 

SMDR_CALC_YTD 

SMDR_CHECK 

SMDR_FIX_OCT 

SMDR_FLOW 

SMDR_TRUNCATE 

SMDR_TRUNC_CUM 

TBL 

UPDATE_SUMMARY 

UPLOAD  TRANSACTION 


Files  in  the  Tools  Catalog. 

File  name 

This  procedure  was  used  to  recompute  the  WG 
pay  rates  after  they  were  entered 
incorrectly . 

This  procedure  patches  the  SF52  table  before 
costs  can  be  calculated  from  it. 

This  procedure  was  used  to  recompute  the 
cumulative  values  in  the  SMDR  database  after 
the  FLOW  attribute  had  been  changed  in  the 
monthly  data. 

This  procedure  was  used  to  subtly  change  the 
format  of  the  SMDR  database. 

This  procedure  renamed  the  footnote  files 
when  the  above  change  took  place.  Note: 
this  procedure  does  not  work  correctly. 

This  procedure  is  used  on  update  the  Year  to 
date  figures  after  edits  have  taken  place. 
Due  to  the  nature  of  Year  to  Date  averages, 
this  procedure  computes  incorrect  figures 
for  averaged  fields. 


This 

FLOW 

procedure 

attribute 

was  used 
of  the  SMDR 

to  determine  the 
database . 

This 

SMDR 

procedure 
data . 

was 

used 

to 

correct 

corrupted 

This 

SMDR 

procedure 
data . 

was 

used 

to 

correct 

corrupted 

This 

SMDR 

procedure 
data . 

was 

used 

to 

correct 

corrupted 

This 

SMDR 

procedure 
data . 

was 

used 

to 

correct 

corrupted 

This  procedure  will  dump  the  table  detail 
table  into  a  text  file  with  UNIX  tbl  com- 

mands  embedded  for  printing. 

This  procedure  will  take  the  C&0__TRANSACTI0N 
table  and  aggregate  it  into  the  C&0_SUMMARY 
table . 

This  procedure  will  upload  all  of  the  ledger 
text  files  from  the  proper  PC  directory. 
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Files  in  the  Tools  Catalog. 

File  name 

SMDREXT  This  is  an  extract  file  that  was  used  to 

extract  the  SMDR  data  from  a  print  image  of 
the  official  version  for  an  original  data 
load. 

GSTABLE  This  file  was  used  to  import  pay  figures 

from  the  General  Service  schedule. 

XPTABLE  This  file  was  used  to  import  pay  figures 

from  the  "XP"  schedule. 


Text  files  in  the  DTIC2  Catalog. 

File  name  Content 

C0ST1F00TN0TE  The  footnote  for  the  C0ST1  screen.  This 

file  contains  an  explanation  of  the  formulas 
used  in  the  personnel  costs  calculations. 

DAVERS  This  file  contains  the  version  number  of  the 

Pilot  Enterview  application. 

WSDOC  This  file  contains  a  description  of  how  to 

use  and  implement  the  Pilot  Worksheet  appli¬ 
cation. 

WSVERS  This  file  contains  the  version  number  of  the 

Pilot  Worksheet  application. 


Text  files  in  the  DTIC2TEXT  Catalog. 
Following  is  a  list  of  SMDR  footnote  text  files . 
File  Name  Title  1  Title2 


SMDRTXT25  Quality  Assurance 
SMDRTXT26  Quality  Assurance 
SMDRTXT28  Quality  Assurance 
SMDRTXT33  Technical  Reports 
SMDRTXT4 0  Technical  Reports 
SMDRTXT42  Technical  Reports 
SMDRTXT43  Technical  Reports 
SMDRTXT45  Technical  Reports 
SMDRTXT51  Technical  Reports 
SMDRTXT60  Work  Unit  Information 
SMDRTXT64  Program  Summary 
SMDRTXT68  Independent  R&D 
SMDRTXT70  Independent  R&D 
SMDRTXT73  DROLS 
SMDRTXT77  DoD  SBIR  Program 


Quality  of  New  Tech  Rpts 
TR  Demand  Usr  Complaints 
DROLS  Response 
New  Record  Collection 
IAC  New  Records 
Reports  Distributed 
Demand  Orders  Processed 
Auto  Doc  Dist  Subscripts 
Bib  Database  Retrieval 
Database  Retrieval 
Database  Retrievals 
In-House  Bibs  Furnished 
Subscript ions /Retrievals 
Interrogations 

Products  Furnished  Participants 
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APPENDIX  B 


The  DIF2QDK  procedure . 
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procedure  dif2qdk (input_name,  output_name) 

declare  string  input_name  output_name, field_name (30) , record (30) , line, void, - 
flag, str, value 
declare  real  temp 

declare  integer  x  y  z  vectors  tuples 
declare  function  unquote  enote 

!  this  procedure  will  take  a  visicalc  spread  sheet  (xxxxx.dif)  and  produce 
!  a  pilot  table.  The  DIF  format  is  as  follows: 

i 

!  First  is  a  header  that  tells  the  number  of  records  (TUPLES)  and  the 
!  number  of  fields  (VECTORS) . 

!  Each  cell  in  the  spread  sheet  has  a  2  line  entry. 

!  The  first  line  contains  two  numbers  delimited  by  a  comma. 

!  The  first  is  a  flag  with  the  following  meanings: 

!  -1  =  next  line  contains  a  special  flag 

!  0  =  this  is  a  numeric  cell 

!  1  =  this  is  a  character  cell 

!  The  second  number  is  0  if  this  is  a  special  or  character  entry.  If  it  is 
!  a  numeric  entry,  however,  the  second  number  is  the  numeric  entry  in  a 
!  ^orm  of  scientific  notation  or  in  normal  integer  form 

!  Tie  second  line  in  each  entry  is  one  of  the  following  depending  on  the 
!  flag  value  in  the  first  line. 

!  if  flag  =  -1  then  second  line  =  (BOT  |  EOD)  where  bot  means  end  of  record 
!  and  eod  means  end  of  data 

!  if  flag  =  0  then  second  line  =  V  meaning  that  this  is  a  numeric  entry 

!  if  flag  =  1  then  second  line  =  a  double  quoted  string  value 

i 

!  The  rows  in  the  spread  sheet  are  delimited  with  a  "-1,0"  line  and  then 
!  a  "BOT"  line. 


if  not  defined (input_name)  then  input_name  =  ask("Type  the  dif  file  name") 
if  not  defined (output_name)  then  output_name  =  ask("Type  the  table  name") 

open  read  1  @input_name. 
for  x  =  1  to  4 

flag  =  read  ( 1 )  !  flag  =  [TABLE|VECTORS|TUPLES|DATA]  In  any  order 

line  =  read(l)  !  0,36  if  flag  =  vectors  36  records  in  this  file 

void  =  read(l)  !  "" 

@flag.  =  dif 2qdk : enote (line) 
next  x 

void  =  read(l)  !  -1,0 

void  =  read(l)  !  BOT 

on  error  then  close  1;  print  "TABLE  EXISTS  "  ;  return  -1 
make  table  @output_name . 
make  field  recnum  numeric 
for  x  =  1  to  vectors 
line  =  "FIELD"+str (x) 
make  field  @line.  character 
next  x 
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for  y  =  1  to  tuples 
build  record  y 
for  x  =  1  to  vectors 
line  =  read(l) 
str  =  read(l) 

!  build  the  record  in  here 

if  line  =  "1,0"  then  value  =  dif2qdk: unquote  (str) 
else  if  line  =  "0, 1 . 797693134862316E+308"  then  value  =  "NA" 
else  value  =  dif2qdk:enote (line) 
build  record  value 
next  x 

!  and  in  here  make  the  record  and  read  past  the  record  terminator 
make  record 
print  y 

void  =  read(l)  !  -1,0 

void  =  read(l)  !  BOT  (EOD  on  the  last  record) 

next  y 
close  1 
pend 


procedure  unquote (str) 
declare  string  str 
declare  integer  loc 

!  unquote  will  remove  all  quote  characters  from  a  string 
!  this  is  the  place  where  special  characters  in  the  input  should  be 
!  translated. 

loc  =  instr (str, """") 
while  loc  <>  0 

str  =  left (str, loc-1)  +  mid (str,  loc+1 , 0 ) 
loc  =  instr (str, """") 
wend 

!  and  now  translate  the  ' char  to  something  innocent  ' ' ' 
str  =  translate (str, "*", "'") 

return  str 
pend 


procedure  enote(str) 

!  this  function  will  return  a  real  value  from  a  string  in  the  scientific 
!  notation  format  that  is  used  in  the  visicalc  dif  format 

declare  string  str 
declare  integer  x 
str  =  mid(str,3,0) 
x  =  instr (str, "E") 
if  x  >  0  then  - 

if  (mid(st-,x+l,l)  =  "+")  then  - 

return  val (left (str, x-1) )  *  10  “  val (mid (str, x+1,  0) ) 
else 
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return  val (left (str, x-1) )  *  1  /  (10  *  val (mid (str,  x+2,  0) ) ) 


else 

return  val (str) 
pend 
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